Skip to main content
The Xquik MCP server exposes 9 tools that AI agents can use to manage monitors, query events, search tweets, look up users, and configure webhooks. Connect to the MCP server on port 3100 with your API key.

​
list-monitors

List all monitored X accounts for the authenticated user. Input: None Example:
Prompt: “Show me all my active monitors”
Tool Call
{
  "name": "list-monitors",
  "arguments": {}
}
Result
[
  {
    "id": "7",
    "xUsername": "elonmusk",
    "eventTypes": ["tweet.new", "tweet.reply"],
    "isActive": true,
    "createdAt": "2026-02-24T10:30:00.000Z"
  },
  {
    "id": "12",
    "xUsername": "OpenAI",
    "eventTypes": ["tweet.new"],
    "isActive": true,
    "createdAt": "2026-02-20T08:00:00.000Z"
  }
]

​
add-monitor

Start monitoring an X account for specific event types. Input:
ParameterTypeRequiredDescription
usernamestringYesX username to monitor (without @)
eventTypesstring[]YesEvent types to subscribe to
Example:
Prompt: “Monitor @elonmusk for new tweets and replies”
Tool Call
{
  "name": "add-monitor",
  "arguments": {
    "username": "elonmusk",
    "eventTypes": ["tweet.new", "tweet.reply"]
  }
}
Result
{
  "id": "7",
  "xUsername": "elonmusk",
  "eventTypes": ["tweet.new", "tweet.reply"],
  "isActive": true,
  "createdAt": "2026-02-24T10:30:00.000Z"
}

​
remove-monitor

Stop monitoring an X account. Input:
ParameterTypeRequiredDescription
monitorIdstringYesID of the monitor to remove
Example:
Prompt: “Stop monitoring the account with monitor ID 7”
Tool Call
{
  "name": "remove-monitor",
  "arguments": {
    "monitorId": "7"
  }
}
Result
"Monitor removed"
If the monitor does not exist, returns "Monitor not found".

​
get-events

Query events from monitored accounts with optional filters and cursor-based pagination. Input:
ParameterTypeRequiredDefaultDescription
limitnumberNo50Results per page (1-100)
monitorIdstringNo-Filter by monitor ID
eventTypestringNo-Filter by event type
afterCursorstringNo-Pagination cursor from previous response
Example:
Prompt: “Get the latest 10 tweets from monitor 7”
Tool Call
{
  "name": "get-events",
  "arguments": {
    "limit": 10,
    "monitorId": "7",
    "eventType": "tweet.new"
  }
}
Result
{
  "events": [
    {
      "id": "9001",
      "eventType": "tweet.new",
      "monitoredAccountId": "7",
      "xUsername": "elonmusk",
      "occurredAt": "2026-02-24T14:22:00.000Z",
      "eventData": {
        "tweetId": "1893456789012345678",
        "text": "The future is now.",
        "metrics": {
          "likes": 42000,
          "retweets": 8500,
          "replies": 3200
        }
      }
    }
  ],
  "hasMore": true,
  "nextCursor": "MjAyNi0wMi0yNFQxNDoyMjowMC4wMDBa"
}
To fetch the next page, pass nextCursor as afterCursor in the next call.

​
get-event

Retrieve a single event by ID with full details. Input:
ParameterTypeRequiredDescription
eventIdstringYesEvent ID to retrieve
Example:
Prompt: “Show me the details of event 9001”
Tool Call
{
  "name": "get-event",
  "arguments": {
    "eventId": "9001"
  }
}
Result
{
  "id": "9001",
  "eventType": "tweet.new",
  "monitoredAccountId": "7",
  "xUsername": "elonmusk",
  "occurredAt": "2026-02-24T14:22:00.000Z",
  "eventData": {
    "tweetId": "1893456789012345678",
    "text": "The future is now.",
    "metrics": {
      "likes": 42000,
      "retweets": 8500,
      "replies": 3200
    }
  }
}
If the event does not exist, returns "Event not found".

​
search-tweets

Search for tweets matching a query. Consumes API usage credits. Input:
ParameterTypeRequiredDescription
querystringYesSearch query (supports X search syntax)
Quota: Consumes usage credits (counts toward your monthly quota) Example:
Prompt: “Search for recent tweets about SpaceX Starship launch”
Tool Call
{
  "name": "search-tweets",
  "arguments": {
    "query": "SpaceX Starship launch"
  }
}
Result
[
  {
    "id": "1893456789012345678",
    "text": "Starship Flight 8 is GO for launch tomorrow morning.",
    "authorUsername": "elonmusk",
    "authorName": "Elon Musk",
    "createdAt": "2026-02-24T14:22:00.000Z"
  },
  {
    "id": "1893456789012345679",
    "text": "Watching the Starship launch live from Boca Chica!",
    "authorUsername": "SpaceX",
    "authorName": "SpaceX",
    "createdAt": "2026-02-24T15:00:00.000Z"
  }
]

​
get-user-info

Get profile information for an X user. Consumes API usage credits. Input:
ParameterTypeRequiredDescription
usernamestringYesX username (without @)
Quota: Consumes usage credits (counts toward your monthly quota) Example:
Prompt: “Get profile info for @elonmusk”
Tool Call
{
  "name": "get-user-info",
  "arguments": {
    "username": "elonmusk"
  }
}
Result
{
  "username": "elonmusk",
  "name": "Elon Musk",
  "description": "Mars & Cars, Chips & Dips",
  "profilePicture": "https://pbs.twimg.com/profile_images/.../photo.jpg",
  "followersCount": 200000000,
  "followingCount": 800
}
If the username does not exist, returns "User not found".

​
list-webhooks

List all webhook endpoints for the authenticated user. Input: None Example:
Prompt: “Show all my webhook endpoints”
Tool Call
{
  "name": "list-webhooks",
  "arguments": {}
}
Result
[
  {
    "id": "15",
    "url": "https://example.com/webhook",
    "eventTypes": ["tweet.new", "tweet.reply"],
    "isActive": true,
    "createdAt": "2026-02-24T10:30:00.000Z"
  }
]

​
add-webhook

Register a new webhook endpoint to receive event notifications. Input:
ParameterTypeRequiredDescription
urlstringYesHTTPS endpoint URL
eventTypesstring[]YesEvent types to receive
Example:
Prompt: “Set up a webhook at https://example.com/webhook for new tweets and retweets”
Tool Call
{
  "name": "add-webhook",
  "arguments": {
    "url": "https://example.com/webhook",
    "eventTypes": ["tweet.new", "tweet.retweet"]
  }
}
Result
{
  "id": "15",
  "url": "https://example.com/webhook",
  "eventTypes": ["tweet.new", "tweet.retweet"],
  "secret": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2",
  "createdAt": "2026-02-24T10:30:00.000Z"
}
The secret is returned only during creation. Store it securely for signature verification.

​
Usage & Quotas

Most MCP tools are free to use. Two tools consume usage credits that count toward your monthly quota:
ToolMeteredNotes
search-tweetsYesPer tweet returned
get-user-infoYesPer lookup
list-monitorsNoUnlimited
add-monitorNoUnlimited
remove-monitorNoUnlimited
get-eventsNoUnlimited
get-eventNoUnlimited
list-webhooksNoUnlimited
add-webhookNoUnlimited
Usage is tracked per billing period. Monitor your current usage from the dashboard or via the GET /account API endpoint. See Billing & Usage for monthly operation limits.