# X MCP guide

This skill guides agents through X connections and MCP tools. Use it when an agent needs to read X data or work with chats, lists, and calls.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 614 installs · ★ 14099
- Author: cursor
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/cursor/plugins/tree/HEAD/third_party/x/skills/x-api-mcp-guide/SKILL.md
- Updated: 2026-10-25
- HTML: https://affpapa.org/en/nevibecode/skills/x-mcp-guide

## What it does

X MCP guide sets out how to connect to X’s hosted MCP server through OAuth. It covers profile and post reads, search, news, trends, Spaces, communities, lists, chats, calls, and livestreams. Public reads do not require the user to connect an X account; account-specific data and actions do.

The skill maps errors to next steps, including when to reconnect the X plugin and when to stop. An unchanged request should not be retried after an authorization error. Access uses the X OAuth connector, so the agent must not request a password, API key, or Bearer token. Posting and starting a livestream in real time are unsupported.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add cursor/plugins --skill x-mcp-guide -a claude-code
```
```bash
npx skills add cursor/plugins --skill x-api-mcp-guide -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/x-api-mcp-guide/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/x-api-mcp-guide/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add cursor/plugins --skill x-api-mcp-guide -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/x-api-mcp-guide/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add cursor/plugins --skill x-api-mcp-guide -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/x-api-mcp-guide/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install cursor/plugins x-api-mcp-guide
```

2. **Manually: put the files in place**
- File: `.github/skills/x-api-mcp-guide/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add cursor/plugins --skill x-api-mcp-guide -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/cursor/plugins --path third_party/x/skills/x-api-mcp-guide
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/x-api-mcp-guide/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add cursor/plugins --skill x-api-mcp-guide -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/cursor/plugins/tree/HEAD/third_party/x/skills/x-api-mcp-guide/SKILL.md

## When to use it
- connect an X account through the OAuth connector
- diagnose why X tools are unavailable
- search X posts, accounts, news, or trends
- read chats and manage X lists
- check scheduled calls and livestreams

## Example prompts
- Search X posts about this topic and count the results.
- Check which X tools are available and explain the connection error.
- Show unread X Chat messages and message requests.

## Similar
- [mcp-builder](https://affpapa.org/en/nevibecode/skills/mcp-builder.md) — skill · 130949 installs
- [claude-api](https://affpapa.org/en/nevibecode/skills/claude-api.md) — skill · 74198 installs
- [lark-im](https://affpapa.org/en/nevibecode/skills/lark-im.md) — skill · 472900 installs
- [lark-event](https://affpapa.org/en/nevibecode/skills/lark-event.md) — skill · 466800 installs
- [caveman-discover](https://affpapa.org/en/nevibecode/skills/caveman-discover.md) — skill · 104400 installs
- [migration](https://affpapa.org/en/nevibecode/skills/migration.md) — skill · 103900 installs

From the same set: [cursor/plugins](https://affpapa.org/en/nevibecode/by/cursor/plugins.md) — 47 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md