MCP

X MCP Server

X reaches around 600 million monthly users through short posts, live commentary, video, and breaking-news conversation, making it important for real-time communications, media visibility, and reputation response.

MCP Version: 1.0.0 38 MCP Tools Authentication
X

Base URL

https://mcp.pressmonitor.ca/mcp

Authentication

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

Authorization: Bearer YOUR_TOKEN

autocomplete

Arguments

Name Type Required Description
value string No

Code Examples

curl -X POST "https://mcp.pressmonitor.ca/mcp" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID" -H "Content-Type: application/json" -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "autocomplete",
    "arguments": {}
  },
  "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.ca/mcp" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID" -H "Content-Type: application/json" -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "comments",
    "arguments": {}
  },
  "id": 1
}'

communityTopics

Code Examples

curl -X POST "https://mcp.pressmonitor.ca/mcp" -H "Authorization: Bearer YOUR_API_KEY" -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.ca/mcp" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID" -H "Content-Type: application/json" -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "CommunityTweets",
    "arguments": {}
  },
  "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.ca/mcp" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID" -H "Content-Type: application/json" -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "fetchPopularCommunities",
    "arguments": {}
  },
  "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.ca/mcp" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID" -H "Content-Type: application/json" -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "followers",
    "arguments": {}
  },
  "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.ca/mcp" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID" -H "Content-Type: application/json" -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "followersIDs",
    "arguments": {}
  },
  "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.ca/mcp" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID" -H "Content-Type: application/json" -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "followings",
    "arguments": {}
  },
  "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.ca/mcp" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID" -H "Content-Type: application/json" -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "followingsIDs",
    "arguments": {}
  },
  "id": 1
}'

getUsers

Get Users

Arguments

Name Type Required Description
users string No Users

Code Examples

curl -X POST "https://mcp.pressmonitor.ca/mcp" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID" -H "Content-Type: application/json" -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "getUsers",
    "arguments": {}
  },
  "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.ca/mcp" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID" -H "Content-Type: application/json" -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "groupTweets",
    "arguments": {}
  },
  "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.ca/mcp" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID" -H "Content-Type: application/json" -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "highlights",
    "arguments": {}
  },
  "id": 1
}'

jobsDetails

Arguments

Name Type Required Description
jobId string No

Code Examples

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

jobsLocationsSuggest

Arguments

Name Type Required Description
query string No Search query

Code Examples

curl -X POST "https://mcp.pressmonitor.ca/mcp" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID" -H "Content-Type: application/json" -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "jobsLocationsSuggest",
    "arguments": {}
  },
  "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.ca/mcp" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID" -H "Content-Type: application/json" -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "jobsSearch",
    "arguments": {}
  },
  "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.ca/mcp" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID" -H "Content-Type: application/json" -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "likes",
    "arguments": {}
  },
  "id": 1
}'

listDetails

Arguments

Name Type Required Description
listId string No

Code Examples

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

listTimeline

Arguments

Name Type Required Description
listId string No

Code Examples

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

listTweets

Arguments

Name Type Required Description
listId string No

Code Examples

curl -X POST "https://mcp.pressmonitor.ca/mcp" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID" -H "Content-Type: application/json" -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "listTweets",
    "arguments": {}
  },
  "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.ca/mcp" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID" -H "Content-Type: application/json" -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "orgAffiliates",
    "arguments": {}
  },
  "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.ca/mcp" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID" -H "Content-Type: application/json" -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "quotes",
    "arguments": {}
  },
  "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.ca/mcp" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID" -H "Content-Type: application/json" -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "retweets",
    "arguments": {}
  },
  "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.ca/mcp" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID" -H "Content-Type: application/json" -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "searchCommunity",
    "arguments": {}
  },
  "id": 1
}'

searchLists

Arguments

Name Type Required Description
query string No Search query

Code Examples

curl -X POST "https://mcp.pressmonitor.ca/mcp" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID" -H "Content-Type: application/json" -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "searchLists",
    "arguments": {}
  },
  "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.ca/mcp" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID" -H "Content-Type: application/json" -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "searchold",
    "arguments": {}
  },
  "id": 1
}'

spaces

Arguments

Name Type Required Description
id string No

Code Examples

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

trendsLocations

Code Examples

curl -X POST "https://mcp.pressmonitor.ca/mcp" -H "Authorization: Bearer YOUR_API_KEY" -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.ca/mcp" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID" -H "Content-Type: application/json" -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "tweet",
    "arguments": {}
  },
  "id": 1
}'

tweetByIds

Arguments

Name Type Required Description
tweetIDs string No

Code Examples

curl -X POST "https://mcp.pressmonitor.ca/mcp" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID" -H "Content-Type: application/json" -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "tweetByIds",
    "arguments": {}
  },
  "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.ca/mcp" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID" -H "Content-Type: application/json" -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "user",
    "arguments": {}
  },
  "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.ca/mcp" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID" -H "Content-Type: application/json" -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "userLikes",
    "arguments": {}
  },
  "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.ca/mcp" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID" -H "Content-Type: application/json" -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "userMedia",
    "arguments": {}
  },
  "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.ca/mcp" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID" -H "Content-Type: application/json" -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "userReplies",
    "arguments": {}
  },
  "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.ca/mcp" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID" -H "Content-Type: application/json" -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "userRepliesV2",
    "arguments": {}
  },
  "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.ca/mcp" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID" -H "Content-Type: application/json" -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "userTweets",
    "arguments": {}
  },
  "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.ca/mcp" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID" -H "Content-Type: application/json" -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "verifiedFollowers",
    "arguments": {}
  },
  "id": 1
}'