MCP

X MCP Server

X (Twitter) users, community managers, journalists, brands, and real-time communication teams.

MCP Version: 1.0.0 38 MCP Tools Authentication
X

Base URL

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

Authentication

MCP calls also use Bearer tokens over JSON-RPC 2.0 requests.

Authorization: Bearer YOUR_TOKEN
x-subscription-id: YOUR_SUB_ID

autocomplete

Arguments

Name Type Required Description
value string No

Code Examples

curl -X POST \
  "https://mcp.pressmonitor.com/x/v1" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "x-subscription-id: YOUR_SUB_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "autocomplete",
    "arguments": {
      "value": "VALUE"
    }
  },
  "id": 1
}'

comments

Arguments

Name Type Required Description
pid string No Pid
rankingMode string No
count integer No Number of results to return
cursor integer No Pagination cursor for next page

Code Examples

curl -X POST \
  "https://mcp.pressmonitor.com/x/v1" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "x-subscription-id: YOUR_SUB_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "comments",
    "arguments": {
      "pid": "VALUE",
      "rankingMode": "VALUE",
      "count": 0,
      "cursor": 0
    }
  },
  "id": 1
}'

communityTopics

Code Examples

curl -X POST \
  "https://mcp.pressmonitor.com/x/v1" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "x-subscription-id: YOUR_SUB_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "communityTopics",
    "arguments": {}
  },
  "id": 1
}'

CommunityTweets

Arguments

Name Type Required Description
communityId string No
count integer No Number of results to return
cursor integer No Pagination cursor for next page

Code Examples

curl -X POST \
  "https://mcp.pressmonitor.com/x/v1" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "x-subscription-id: YOUR_SUB_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "CommunityTweets",
    "arguments": {
      "communityId": "VALUE",
      "count": 0,
      "cursor": 0
    }
  },
  "id": 1
}'

fetchPopularCommunities

Arguments

Name Type Required Description
topicId string No
count integer No Number of results to return

Code Examples

curl -X POST \
  "https://mcp.pressmonitor.com/x/v1" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "x-subscription-id: YOUR_SUB_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "fetchPopularCommunities",
    "arguments": {
      "topicId": "VALUE",
      "count": 0
    }
  },
  "id": 1
}'

followers

Followers

Arguments

Name Type Required Description
user string No Numeric User ID (not username). Use 'user' endpoint to lookup ID from username
count integer No Number of results to return
cursor integer No Pagination cursor for next page

Code Examples

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

followersIDs

Arguments

Name Type Required Description
username string No Username (screen name without @ symbol, e.g., 'elonmusk')
count integer No Number of results to return

Code Examples

curl -X POST \
  "https://mcp.pressmonitor.com/x/v1" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "x-subscription-id: YOUR_SUB_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "followersIDs",
    "arguments": {
      "username": "VALUE",
      "count": 0
    }
  },
  "id": 1
}'

followings

Followings

Arguments

Name Type Required Description
user string No Numeric User ID (not username). Use 'user' endpoint to lookup ID from username
count integer No Number of results to return
cursor integer No Pagination cursor for next page

Code Examples

curl -X POST \
  "https://mcp.pressmonitor.com/x/v1" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "x-subscription-id: YOUR_SUB_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "followings",
    "arguments": {
      "user": "VALUE",
      "count": 0,
      "cursor": 0
    }
  },
  "id": 1
}'

followingsIDs

Arguments

Name Type Required Description
username string No Username (screen name without @ symbol, e.g., 'elonmusk')
count integer No Number of results to return

Code Examples

curl -X POST \
  "https://mcp.pressmonitor.com/x/v1" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "x-subscription-id: YOUR_SUB_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "followingsIDs",
    "arguments": {
      "username": "VALUE",
      "count": 0
    }
  },
  "id": 1
}'

getUsers

Get Users

Arguments

Name Type Required Description
users string No Users

Code Examples

curl -X POST \
  "https://mcp.pressmonitor.com/x/v1" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "x-subscription-id: YOUR_SUB_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "getUsers",
    "arguments": {
      "users": "VALUE"
    }
  },
  "id": 1
}'

groupTweets

Arguments

Name Type Required Description
communityId string No
rankingMode string No
searchType string No
count integer No Number of results to return
cursor integer No Pagination cursor for next page

Code Examples

curl -X POST \
  "https://mcp.pressmonitor.com/x/v1" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "x-subscription-id: YOUR_SUB_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "groupTweets",
    "arguments": {
      "communityId": "VALUE",
      "rankingMode": "VALUE",
      "searchType": "VALUE",
      "count": 0,
      "cursor": 0
    }
  },
  "id": 1
}'

highlights

Arguments

Name Type Required Description
user string No Numeric User ID (not username). Use 'user' endpoint to lookup ID from username
count integer No Number of results to return
cursor integer No Pagination cursor for next page

Code Examples

curl -X POST \
  "https://mcp.pressmonitor.com/x/v1" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "x-subscription-id: YOUR_SUB_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "highlights",
    "arguments": {
      "user": "VALUE",
      "count": 0,
      "cursor": 0
    }
  },
  "id": 1
}'

jobsDetails

Arguments

Name Type Required Description
jobId string No

Code Examples

curl -X POST \
  "https://mcp.pressmonitor.com/x/v1" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "x-subscription-id: YOUR_SUB_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "jobsDetails",
    "arguments": {
      "jobId": "VALUE"
    }
  },
  "id": 1
}'

jobsLocationsSuggest

Arguments

Name Type Required Description
query string No Search query

Code Examples

curl -X POST \
  "https://mcp.pressmonitor.com/x/v1" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "x-subscription-id: YOUR_SUB_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "jobsLocationsSuggest",
    "arguments": {
      "query": "VALUE"
    }
  },
  "id": 1
}'

jobsSearch

Arguments

Name Type Required Description
employment_type string No
job_location_id string No
job_location_type string No
keyword string No
seniority_level string No
count integer No Number of results to return
cursor integer No Pagination cursor for next page

Code Examples

curl -X POST \
  "https://mcp.pressmonitor.com/x/v1" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "x-subscription-id: YOUR_SUB_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "jobsSearch",
    "arguments": {
      "employment_type": "VALUE",
      "job_location_id": "VALUE",
      "job_location_type": "VALUE",
      "keyword": "VALUE",
      "seniority_level": "VALUE",
      "count": 0,
      "cursor": 0
    }
  },
  "id": 1
}'

likes

Arguments

Name Type Required Description
pid string No Pid
count integer No Number of results to return

Code Examples

curl -X POST \
  "https://mcp.pressmonitor.com/x/v1" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "x-subscription-id: YOUR_SUB_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "likes",
    "arguments": {
      "pid": "VALUE",
      "count": 0
    }
  },
  "id": 1
}'

listDetails

Arguments

Name Type Required Description
listId string No

Code Examples

curl -X POST \
  "https://mcp.pressmonitor.com/x/v1" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "x-subscription-id: YOUR_SUB_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "listDetails",
    "arguments": {
      "listId": "VALUE"
    }
  },
  "id": 1
}'

listTimeline

Arguments

Name Type Required Description
listId string No

Code Examples

curl -X POST \
  "https://mcp.pressmonitor.com/x/v1" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "x-subscription-id: YOUR_SUB_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "listTimeline",
    "arguments": {
      "listId": "VALUE"
    }
  },
  "id": 1
}'

listTweets

Arguments

Name Type Required Description
listId string No

Code Examples

curl -X POST \
  "https://mcp.pressmonitor.com/x/v1" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "x-subscription-id: YOUR_SUB_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "listTweets",
    "arguments": {
      "listId": "VALUE"
    }
  },
  "id": 1
}'

orgAffiliates

Arguments

Name Type Required Description
user string No Numeric User ID (not username). Use 'user' endpoint to lookup ID from username
count integer No Number of results to return
cursor integer No Pagination cursor for next page

Code Examples

curl -X POST \
  "https://mcp.pressmonitor.com/x/v1" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "x-subscription-id: YOUR_SUB_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "orgAffiliates",
    "arguments": {
      "user": "VALUE",
      "count": 0,
      "cursor": 0
    }
  },
  "id": 1
}'

quotes

Arguments

Name Type Required Description
pid string No Pid
count integer No Number of results to return
cursor integer No Pagination cursor for next page

Code Examples

curl -X POST \
  "https://mcp.pressmonitor.com/x/v1" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "x-subscription-id: YOUR_SUB_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "quotes",
    "arguments": {
      "pid": "VALUE",
      "count": 0,
      "cursor": 0
    }
  },
  "id": 1
}'

retweets

Arguments

Name Type Required Description
pid string No Pid
count integer No Number of results to return
cursor integer No Pagination cursor for next page

Code Examples

curl -X POST \
  "https://mcp.pressmonitor.com/x/v1" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "x-subscription-id: YOUR_SUB_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "retweets",
    "arguments": {
      "pid": "VALUE",
      "count": 0,
      "cursor": 0
    }
  },
  "id": 1
}'

searchCommunity

Arguments

Name Type Required Description
query string No Search query
count integer No Number of results to return
cursor integer No Pagination cursor for next page

Code Examples

curl -X POST \
  "https://mcp.pressmonitor.com/x/v1" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "x-subscription-id: YOUR_SUB_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "searchCommunity",
    "arguments": {
      "query": "VALUE",
      "count": 0,
      "cursor": 0
    }
  },
  "id": 1
}'

searchLists

Arguments

Name Type Required Description
query string No Search query

Code Examples

curl -X POST \
  "https://mcp.pressmonitor.com/x/v1" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "x-subscription-id: YOUR_SUB_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "searchLists",
    "arguments": {
      "query": "VALUE"
    }
  },
  "id": 1
}'

searchold

Arguments

Name Type Required Description
query string No Search query
type string No Type
count integer No Number of results to return
cursor integer No Pagination cursor for next page

Code Examples

curl -X POST \
  "https://mcp.pressmonitor.com/x/v1" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "x-subscription-id: YOUR_SUB_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "searchold",
    "arguments": {
      "query": "VALUE",
      "type": "VALUE",
      "count": 0,
      "cursor": 0
    }
  },
  "id": 1
}'

spaces

Arguments

Name Type Required Description
id string No

Code Examples

curl -X POST \
  "https://mcp.pressmonitor.com/x/v1" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "x-subscription-id: YOUR_SUB_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "spaces",
    "arguments": {
      "id": "VALUE"
    }
  },
  "id": 1
}'

trendsLocations

Code Examples

curl -X POST \
  "https://mcp.pressmonitor.com/x/v1" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "x-subscription-id: YOUR_SUB_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "trendsLocations",
    "arguments": {}
  },
  "id": 1
}'

tweet

Tweet

Arguments

Name Type Required Description
pid string No Pid

Code Examples

curl -X POST \
  "https://mcp.pressmonitor.com/x/v1" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "x-subscription-id: YOUR_SUB_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "tweet",
    "arguments": {
      "pid": "VALUE"
    }
  },
  "id": 1
}'

tweetByIds

Arguments

Name Type Required Description
tweetIDs string No

Code Examples

curl -X POST \
  "https://mcp.pressmonitor.com/x/v1" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "x-subscription-id: YOUR_SUB_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "tweetByIds",
    "arguments": {
      "tweetIDs": "VALUE"
    }
  },
  "id": 1
}'

user

Lookup user profile by username. Returns user details including numeric user ID (rest_id)

Arguments

Name Type Required Description
username string No Username (screen name without @ symbol, e.g., 'elonmusk')

Code Examples

curl -X POST \
  "https://mcp.pressmonitor.com/x/v1" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "x-subscription-id: YOUR_SUB_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "user",
    "arguments": {
      "username": "VALUE"
    }
  },
  "id": 1
}'

userLikes

Arguments

Name Type Required Description
user string No Numeric User ID (not username). Use 'user' endpoint to lookup ID from username
count integer No Number of results to return

Code Examples

curl -X POST \
  "https://mcp.pressmonitor.com/x/v1" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "x-subscription-id: YOUR_SUB_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "userLikes",
    "arguments": {
      "user": "VALUE",
      "count": 0
    }
  },
  "id": 1
}'

userMedia

Arguments

Name Type Required Description
user string No Numeric User ID (not username). Use 'user' endpoint to lookup ID from username
count integer No Number of results to return
cursor integer No Pagination cursor for next page

Code Examples

curl -X POST \
  "https://mcp.pressmonitor.com/x/v1" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "x-subscription-id: YOUR_SUB_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "userMedia",
    "arguments": {
      "user": "VALUE",
      "count": 0,
      "cursor": 0
    }
  },
  "id": 1
}'

userReplies

Arguments

Name Type Required Description
user string No Numeric User ID (not username). Use 'user' endpoint to lookup ID from username
count integer No Number of results to return
cursor integer No Pagination cursor for next page

Code Examples

curl -X POST \
  "https://mcp.pressmonitor.com/x/v1" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "x-subscription-id: YOUR_SUB_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "userReplies",
    "arguments": {
      "user": "VALUE",
      "count": 0,
      "cursor": 0
    }
  },
  "id": 1
}'

userRepliesV2

Arguments

Name Type Required Description
user string No Numeric User ID (not username). Use 'user' endpoint to lookup ID from username
count integer No Number of results to return
cursor integer No Pagination cursor for next page

Code Examples

curl -X POST \
  "https://mcp.pressmonitor.com/x/v1" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "x-subscription-id: YOUR_SUB_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "userRepliesV2",
    "arguments": {
      "user": "VALUE",
      "count": 0,
      "cursor": 0
    }
  },
  "id": 1
}'

userTweets

Get tweets from a user by their numeric user ID. To get tweets by username, first use 'user' endpoint to lookup the user ID

Arguments

Name Type Required Description
user string No Numeric User ID (not username). Use 'user' endpoint to lookup ID from username
count integer No Number of results to return
cursor integer No Pagination cursor for next page

Code Examples

curl -X POST \
  "https://mcp.pressmonitor.com/x/v1" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "x-subscription-id: YOUR_SUB_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "userTweets",
    "arguments": {
      "user": "VALUE",
      "count": 0,
      "cursor": 0
    }
  },
  "id": 1
}'

verifiedFollowers

Verified Followers

Arguments

Name Type Required Description
user string No Numeric User ID (not username). Use 'user' endpoint to lookup ID from username
count integer No Number of results to return
cursor integer No Pagination cursor for next page

Code Examples

curl -X POST \
  "https://mcp.pressmonitor.com/x/v1" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "x-subscription-id: YOUR_SUB_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "verifiedFollowers",
    "arguments": {
      "user": "VALUE",
      "count": 0,
      "cursor": 0
    }
  },
  "id": 1
}'