Docs MCP server for tweet, follower & webhook docs

Xquik documentation is available as an MCP server at https://docs.xquik.com/mcp. AI tools can search the full docs site and retrieve indexed public pages - API reference, guides, examples, and type definitions - during conversations. This differs from the Xquik API MCP server at xquik.com/mcp. That server searches tweets, looks up profiles, exports followers, runs draws, and manages monitors. The docs MCP server is read-only and requires no authentication.

Codex CLI 0.147.0 and newer support Xquik OAuth. Older Codex and affected Goose releases can connect to this authentication-free Docs MCP server when API MCP OAuth reports Authorization server response missing required issuer: expected https://xquik.com. Retrieve Codex and Goose OAuth issuer validation, then configure the API key fallback for the authenticated API MCP server. Issue #31573 records the Codex fix.

Agent route checklist

Read docs first

Use Docs MCP at https://docs.xquik.com/mcp for public docs, API parameters, examples, error codes, SDK guidance, and no-auth page retrieval.

Run account actions

Use API MCP at https://xquik.com/mcp for live X reads, writes, monitors, webhooks, draws, or extraction jobs. Authenticate with an API key or OAuth 2.1. Prefer OAuth when the client supports browser authorization.

Persist outside chat

Use REST or generated SDKs when a backend must own retries, cursor storage, file downloads, queues, or batch orchestration.

Hand off results

Store the endpoint path, request parameters, returned IDs, has_more, next_cursor, export route, or webhook replay route before ending the agent run.

Quick connect

Use the contextual menu at the top of any docs page:

Copy MCP Server URL. Copies https://docs.xquik.com/mcp to your clipboard.
Copy MCP Install Command. Copies the npx add-mcp install command.
Connect to Cursor. Installs the docs MCP server in Cursor.
Connect to VS Code. Installs the docs MCP server in VS Code.

Search docs through NLWeb

GET or POST https://xquik.com/ask searches public docs through NLWeb 0.55. It needs no authentication. Never send secrets or private data.

curl 'https://xquik.com/ask?query=How%20does%20MCP%20OAuth%20work%3F'

Send JSON, form data, or query parameters. Structured 0.54 requests remain compatible. JSON uses conversational_search and lowercase response types. Set prefer.streaming to true for SSE. Streams emit start, result, and complete events.

Search docs through A2A

The public A2A 1.0 agent card lives at https://xquik.com/.well-known/agent-card.json. It advertises the JSON-RPC endpoint at https://xquik.com/a2a. Send a SendMessage request with A2A-Version: 1.0. The agent accepts text questions and returns the same public documentation results as NLWeb. It needs no authentication and cannot run extractions or account actions. Streaming, push notifications, and extended cards are not advertised.

Setup

Web clients

Claude.ai (web)
ChatGPT

Open Claude Connectors or Customize > Connectors.
Select Add custom connector.
Enter:
- Name: Xquik Docs
- URL: https://docs.xquik.com/mcp
Select Add.
In a chat, select + > Connectors and enable Xquik Docs.

In ChatGPT on the web, open Settings > Security and login. Enable Developer mode.
Open Settings > Plugins. Select +.
Enter https://docs.xquik.com/mcp, then select Create.
Start a new chat. Select + > More, then select Xquik Docs.

The Docs MCP server uses only read and fetch operations, so it fits ChatGPT Pro’s current custom-app permission limit. Link it on the web first. The linked app then appears on mobile. Follow OpenAI’s current setup guide when ChatGPT changes its labels.

Coding agents

Claude Code
Codex
GitHub Copilot CLI
Gemini CLI

claude mcp add --transport http xquik-docs https://docs.xquik.com/mcp

Verify with:

claude mcp list

codex mcp add xquik-docs --url https://docs.xquik.com/mcp
codex mcp list

copilot mcp add --transport http xquik-docs https://docs.xquik.com/mcp

If your installed build does not expose these flags, start Copilot CLI and run /mcp add. Choose HTTP, enter the server name and URL, keep * for tools, then press Ctrl+S. Verify it with /mcp show xquik-docs.

gemini mcp add --transport http xquik-docs https://docs.xquik.com/mcp

Or add this entry under mcpServers in ~/.gemini/settings.json or .gemini/settings.json:

{
  "xquik-docs": {
    "type": "http",
    "url": "https://docs.xquik.com/mcp"
  }
}

Older Gemini CLI builds also accept the legacy httpUrl field.

Additional coding agents

Qwen Code
Goose
Pi

qwen mcp add --transport http xquik-docs https://docs.xquik.com/mcp

Manual Qwen Code configuration still uses httpUrl: "https://docs.xquik.com/mcp" under mcpServers.

Start a session with the Docs MCP extension:

goose session --with-streamable-http-extension https://docs.xquik.com/mcp

Docs MCP needs no OAuth or API-key header, so affected Goose issuer callback defect does not affect this connection.

Pi has no native MCP client. Install and audit a community MCP adapter before adding https://docs.xquik.com/mcp. Xquik does not claim native Pi support.

Editor clients

Cursor
VS Code
Windsurf
OpenCode

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project):

{
  "mcpServers": {
    "xquik-docs": {
      "url": "https://docs.xquik.com/mcp"
    }
  }
}

Add to .vscode/mcp.json (project) or use MCP: Open User Configuration (global):

{
  "servers": {
    "xquik-docs": {
      "type": "http",
      "url": "https://docs.xquik.com/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "xquik-docs": {
      "serverUrl": "https://docs.xquik.com/mcp"
    }
  }
}

Add to opencode.json:

{
  "mcp": {
    "xquik-docs": {
      "type": "remote",
      "url": "https://docs.xquik.com/mcp"
    }
  }
}

Additional editors

Cline
Roo Code

Run cline mcp, add a Streamable HTTP server, and enter https://docs.xquik.com/mcp. In the IDE, use the MCP Remote Servers UI. Cline stores global MCP settings at ~/.cline/data/settings/cline_mcp_settings.json; project settings use .cline/mcp.json.

Roo Code is archived. Its final release can still connect to this authentication-free server. Add to project .roo/mcp.json or global mcp_settings.json:

{
  "mcpServers": {
    "xquik-docs": {
      "type": "streamable-http",
      "url": "https://docs.xquik.com/mcp"
    }
  }
}

Using both MCP servers

For the best experience, connect both:

Docs MCP (docs.xquik.com/mcp) - the AI searches documentation to understand API parameters, error codes, and usage patterns.
API MCP (xquik.com/mcp) - the AI executes actions: searches tweets, runs extractions, sets up monitors.

The AI decides which server to query based on context. A question about how draw filters work hits the docs server. A request to run a draw hits the API server. API MCP results use the normalized v1 contract: snake_case fields, date-time fields as Unix seconds, structured errors, has_more, and next_cursor. Docs MCP returns indexed documentation text and never executes account actions.

What gets searched

The docs MCP server indexes all public pages:

API reference (130 documented operations)
Guides (workflows, error handling, rate limits, billing, extraction workflow, trends, webhook testing)
Webhook documentation (overview, signature verification)
MCP server setup and tools reference
OAuth 2.1 documentation
Architecture, troubleshooting, and type definitions
llms.txt (compact documentation index)

Getting started

SDKs

Guides

Webhooks

MCP server

Agent plugins

Framework guides

OAuth

MPP

Resources

Docs MCP server for tweet, follower & webhook docs

Agent route checklist

Read docs first

Run account actions

Persist outside chat

Hand off results

Quick connect

Search docs through NLWeb

Search docs through A2A

Setup

Web clients

Coding agents

Additional coding agents

Editor clients

Additional editors

Using both MCP servers

What gets searched

​Agent route checklist

Read docs first

Run account actions

Persist outside chat

Hand off results

​Quick connect

​Search docs through NLWeb

​Search docs through A2A

​Setup

​Web clients

​Coding agents

​Additional coding agents

​Editor clients

​Additional editors

​Using both MCP servers

​What gets searched

Agent route checklist

Quick connect

Search docs through NLWeb

Search docs through A2A

Setup

Web clients

Coding agents

Additional coding agents

Editor clients

Additional editors

Using both MCP servers

What gets searched