Press Monitor X / Twitter MCP Server

Onboarding Instructions

The Press Monitor X MCP Server exposes Twitter/X tools over JSON-RPC 2.0 for AI agents and automations. All tool names map 1:1 to the API operationIds, with structured output that includes a data envelope (items + pagination) and credits for metering.

---

Base URL

Base Endpoint:

https://mcp.pressmonitor.com/x/v1

OpenAPI Schema: Download Schema

---

Authentication

All endpoints require Bearer Token authentication:

Authorization: Bearer YOUR_TOKEN

Each request deducts credits based on content type. Credits and request IDs are returned in responses for usage tracking.

---

Discover Tools

List the available tools via JSON-RPC:

curl -s -X POST "https://mcp.pressmonitor.com/x/v1" -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Common tools (operationId = tool name): search, tweet, user, followers, followings, userTweets, getUsers, verifiedFollowers.

---

Example: Call search

curl -s -X POST "https://mcp.pressmonitor.com/x/v1" -H "Content-Type: application/json" -H "Authorization: Bearer YOUR_TOKEN" -d '{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "search", "arguments": { "query": "AI safety", "type": "Top", "count": "25" } } }'

Expected output envelope:

{ "jsonrpc": "2.0", "id": 1, "result": { "content": [{ "type": "json", "json": { "data": { "items": [ /* array of tweets/users/media depending on type */ ], "next_cursor": "string or null" }, "credits": { "rate": 1, "quantity": 1, "total": 1, "request_id": "..." } } }] } }

---

Example: Followers

curl -s -X POST "https://mcp.pressmonitor.com/x/v1" -H "Content-Type: application/json" -H "Authorization: Bearer YOUR_TOKEN" -d '{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "followers", "arguments": { "user": "44196397", "count": "50" } } }'

---

Client Config Snippet (mcp.json)

{ "mcpServers": { "pressmonitor-x": { "command": "npx", "args": [ "-y", "mcp-remote", "https://mcp.pressmonitor.com/x/v1", "--header", "Authorization: Bearer ${X_API_TOKEN}" ], "env": { "X_API_TOKEN": "" } } } }

---

Tips

• Keep count reasonable (e.g., 25–100) and always reuse next_cursor for pagination.
• Tool outputs follow the declared outputSchema with data.items and data.next_cursor plus credits.
• For reproducible analytics, store request/response pairs with timestamps and request IDs.

---

Support

Docs & Guides: https://www.pressmonitor.com/en/docs/twitter-x-api Email: support@pressmonitor.com