Connect AI Agents via MCP

Documentation Index

Fetch the complete documentation index at: https://docs.xquik.com/llms.txt

Use this file to discover all available pages before exploring further.

​

Connection

https://xquik.com/.well-known/mcp.json

​

Authentication

• API key (x-api-key header): Used by Claude Code, Cursor, VS Code, Windsurf, Codex CLI, OpenCode, and Claude Desktop. Pass your key during the MCP handshake.
• OAuth 2.1 (Bearer token): Used by Claude.ai (web) and ChatGPT Developer Mode. OAuth handles authentication automatically via browser login. No API key needed. See OAuth 2.1 documentation for the complete authorization flow, token lifetimes, and implementation details.

​

How it works

​

explore tool

interface EndpointInfo {
  method: string;
  path: string;
  summary: string;
  category: string; // account, composition, credits, extraction, media, monitoring, support, twitter, x-accounts, x-write
  free: boolean;
  parameters?: Array<{ name: string; in: 'query' | 'path' | 'body'; required: boolean; type: string; description: string }>;
  responseShape?: string;
}

declare const spec: { endpoints: EndpointInfo[] };

​

xquik tool

declare const xquik: {
  request(path: string, options?: {
    method?: string;  // default: 'GET'
    body?: unknown;
    query?: Record<string, string>;
  }): Promise<unknown>;
};
declare const spec: { endpoints: EndpointInfo[] };

​

MCP vs REST API

​

Setup

​

Web and terminal clients

{
  "mcpServers": {
    "xquik": {
      "command": "npx",
      "args": [
        "mcp-remote@latest",
        "https://xquik.com/mcp",
        "--header",
        "x-api-key:xq_YOUR_KEY_HERE"
      ]
    }
  }
}

{
  "mcpServers": {
    "xquik": {
      "type": "http",
      "url": "https://xquik.com/mcp",
      "headers": {
        "x-api-key": "xq_YOUR_KEY_HERE"
      }
    }
  }
}

[mcp_servers.xquik]
url = "https://xquik.com/mcp"
http_headers = { "x-api-key" = "xq_YOUR_KEY_HERE" }

​

Editor clients

{
  "mcpServers": {
    "xquik": {
      "url": "https://xquik.com/mcp",
      "headers": {
        "x-api-key": "xq_YOUR_KEY_HERE"
      }
    }
  }
}

{
  "servers": {
    "xquik": {
      "type": "http",
      "url": "https://xquik.com/mcp",
      "headers": {
        "x-api-key": "xq_YOUR_KEY_HERE"
      }
    }
  }
}

{
  "mcpServers": {
    "xquik": {
      "serverUrl": "https://xquik.com/mcp",
      "headers": {
        "x-api-key": "xq_YOUR_KEY_HERE"
      }
    }
  }
}

{
  "mcp": {
    "xquik": {
      "type": "remote",
      "url": "https://xquik.com/mcp",
      "headers": {
        "x-api-key": "xq_YOUR_KEY_HERE"
      }
    }
  }
}

​

ChatGPT

from agents.mcp import MCPServerStreamableHttp

async with MCPServerStreamableHttp(
    url="https://xquik.com/mcp",
    headers={"x-api-key": "xq_YOUR_KEY_HERE"},
    params={},
) as xquik:
    # use xquik as a tool provider
    pass

​

Example prompts

• Start watching @elonmusk for new tweets and replies.
• List the accounts I am currently monitoring.
• Show monitored account activity from today.
• Replay stored events for monitor mon_123 using the last next_cursor as after.
• Stop tracking @elonmusk.

• Search recent X posts about TypeScript.
• Find recent tweets from @vercel.
• Read this tweet: https://x.com/elonmusk/status/1893456789012345678
• Get metrics for this tweet: https://x.com/vercel/status/1893704267862470862

• Get @xquikcom follower count.
• Read @openai profile bio.
• Check whether @elonmusk follows @SpaceX.
• Check whether @vercel and @nextjs follow each other.

• Show current X trends.
• Show top trending topics in the US.
• Check whether AI is trending today.

• Show current Hacker News trends.
• Show top GitHub trending repos today.
• Show fastest-growing startup trends.
• Get Reddit trending topics from the last 12 hours.
• Show popular Wikipedia pages right now.
• Show Google Trends for Turkey.
• Find trending tech news and draft a tweet about one item.

• Pull all replies to this tweet: https://x.com/elonmusk/status/1893456789012345678
• List users who retweeted this tweet: https://x.com/vercel/status/1893704267862470862
• Estimate the cost to extract all followers of @elonmusk.
• Get quote tweets for this post: https://x.com/openai/status/1893456789012345678
• Extract the full thread for this tweet: https://x.com/elonmusk/status/1893704267862470862

• Pick 3 random winners from this tweet: https://x.com/xquikcom/status/1893456789012345678
• Run a giveaway draw where participants must have retweeted and have at least 100 followers.
• Show the results of my last giveaway draw.

• Set up a webhook at https://my-server.com/events for new tweets.
• List configured webhook endpoints.
• Remove the webhook pointing to my old server.

• Write a casual launch tweet for my new product.
• Optimize the draft for engagement.
• Score this draft: Just shipped v2.0 of our API. What do you think?
• Improve this tweet to get more replies.

• Analyze how @elonmusk tweets.
• Compare @vercel and @nextjs tweeting styles.
• Show cached tweet performance.
• Save this tweet draft for later.
• Show all saved drafts.
• Set my X account to @myusername.

• Post a tweet saying: Just shipped v2.0!
• Like this tweet: https://x.com/vercel/status/1893704267862470862
• Retweet this: https://x.com/openai/status/1893456789012345678
• Follow @vercel from my connected account.
• Send a DM to user ID 44196397 saying hello.
• Post a tweet saying: New feature! Use public image URL https://example.com/launch.png.

• Show my plan and month-to-date usage.
• Check whether I have enough budget left for a large extraction.

​

Framework guides

​

AI agent skill

npx skills add Xquik-dev/x-twitter-scraper