Connect AI Agents via MCP

​

Connection

​

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, bot, composition, credits, extraction, integrations, 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

{
  "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"
      }
    }
  }
}

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

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

{
  "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"
      }
    }
  }
}

​

Example prompts

• “Can you start watching @elonmusk for new tweets and replies?”
• “What accounts am I currently monitoring?”
• “Has anything happened on my monitored accounts today?”
• “Stop tracking @elonmusk, I don’t need updates anymore.”

• “What are people saying about TypeScript on X right now?”
• “Can you find recent tweets from @vercel?”
• “What does this tweet say? https://x.com/elonmusk/status/1893456789012345678”
• “How many likes and retweets does this have? https://x.com/vercel/status/1893704267862470862”

• “How many followers does @xquikcom have?”
• “What does @openai’s bio say?”
• “Does @elonmusk follow @SpaceX back?”
• “Are @vercel and @nextjs following each other?”

• “What’s trending on X right now?”
• “What are the top trending topics in the US?”
• “Is there anything trending about AI today?”

• “What’s trending on Hacker News right now?”
• “Show me the top GitHub trending repos today”
• “What are the fastest-growing startups on TrustMRR?”
• “Get me trending topics from Reddit in the last 12 hours”
• “What’s popular on Wikipedia right now?”
• “Show me Google Trends for Turkey”
• “Find trending tech news and help me compose a tweet about one”

• “Can you pull all the replies to this tweet? https://x.com/elonmusk/status/1893456789012345678”
• “Who retweeted this? https://x.com/vercel/status/1893704267862470862”
• “How much would it cost to extract all followers of @elonmusk?”
• “Get me all the quote tweets on this post: https://x.com/openai/status/1893456789012345678”
• “Can you 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 me the results of my last giveaway draw.”

• “Can you set up a webhook at https://my-server.com/events for new tweets?”
• “What webhook endpoints do I have configured?”
• “Remove the webhook pointing to my old server.”

• “Help me write a tweet about launching my new product”
• “I want it casual and optimized for engagement”
• “Score this draft: Just shipped v2.0 of our API. What do you think?”
• “How can I improve this tweet to get more replies?”

• “Analyze how @elonmusk tweets”
• “Compare @vercel and @nextjs tweeting styles”
• “How are my cached tweets performing?”
• “Save this tweet draft for later”
• “Show me all my 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”
• “Update my bio to: Building cool stuff with AI”
• “Upload this image and tweet it with the caption: New feature!”

• “Set up a Telegram integration to my chat”
• “List my integrations”
• “Send a test notification to my Telegram bot”

• “What plan am I on and how much have I used this month?”
• “Do I have enough budget left to run a large extraction?”

​

Framework guides

​

AI agent skill

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