MCP

X Monitor MCP Server

The AI-powered X provides 360° Global Media Data & Intelligence on X (Twitter) users, community managers, journalists, brands, and real-time communication teams.

MCP Version: 1.0.0 7 MCP Tools Authentication

Base URL

https://pressmonitor.ca/mcp

Authentication

MCP calls require x-api-key and x-subscription-id headers on every JSON-RPC 2.0 request.

x-api-key: YOUR_API_KEY
x-subscription-id: YOUR_SUB_ID

twitter_user

Get a simplified user profile by screen name

Arguments

Name	Type	Required	Description
username	`string`	Yes	Username

Code Examples

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

import requests, json

payload = {
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "twitter_user",
    "arguments": {
      "username": "VALUE"
    }
  },
  "id": 1
}
headers = {"x-api-key": "YOUR_API_KEY", "x-subscription-id": "YOUR_SUB_ID"}
response = requests.post("https://pressmonitor.ca/mcp", json=payload, headers=headers)
print(response.json())

const payload = {
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "twitter_user",
    "arguments": {
      "username": "VALUE"
    }
  },
  "id": 1
};

fetch("https://pressmonitor.ca/mcp", {
  method: "POST",
  headers: {"x-api-key": "YOUR_API_KEY", "x-subscription-id": "YOUR_SUB_ID"},
  body: JSON.stringify(payload)
})
  .then(r => r.json())
  .then(console.log);

twitter_tweets

Get simplified tweets by screen name

Arguments

Name	Type	Required	Description
username	`string`	Yes	Username
count	`integer`	No	Number of results

Code Examples

curl -X POST \
  "https://pressmonitor.ca/mcp" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-subscription-id: YOUR_SUB_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "twitter_tweets",
    "arguments": {
      "username": "VALUE",
      "count": 0
    }
  },
  "id": 1
}'

import requests, json

payload = {
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "twitter_tweets",
    "arguments": {
      "username": "VALUE",
      "count": 0
    }
  },
  "id": 1
}
headers = {"x-api-key": "YOUR_API_KEY", "x-subscription-id": "YOUR_SUB_ID"}
response = requests.post("https://pressmonitor.ca/mcp", json=payload, headers=headers)
print(response.json())

const payload = {
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "twitter_tweets",
    "arguments": {
      "username": "VALUE",
      "count": 0
    }
  },
  "id": 1
};

fetch("https://pressmonitor.ca/mcp", {
  method: "POST",
  headers: {"x-api-key": "YOUR_API_KEY", "x-subscription-id": "YOUR_SUB_ID"},
  body: JSON.stringify(payload)
})
  .then(r => r.json())
  .then(console.log);

twitter_search

Search for simplified tweets

Arguments

Name	Type	Required	Description
query	`string`	Yes	Search query
count	`integer`	No	Number of results

Code Examples

curl -X POST \
  "https://pressmonitor.ca/mcp" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-subscription-id: YOUR_SUB_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "twitter_search",
    "arguments": {
      "query": "VALUE",
      "count": 0
    }
  },
  "id": 1
}'

import requests, json

payload = {
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "twitter_search",
    "arguments": {
      "query": "VALUE",
      "count": 0
    }
  },
  "id": 1
}
headers = {"x-api-key": "YOUR_API_KEY", "x-subscription-id": "YOUR_SUB_ID"}
response = requests.post("https://pressmonitor.ca/mcp", json=payload, headers=headers)
print(response.json())

const payload = {
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "twitter_search",
    "arguments": {
      "query": "VALUE",
      "count": 0
    }
  },
  "id": 1
};

fetch("https://pressmonitor.ca/mcp", {
  method: "POST",
  headers: {"x-api-key": "YOUR_API_KEY", "x-subscription-id": "YOUR_SUB_ID"},
  body: JSON.stringify(payload)
})
  .then(r => r.json())
  .then(console.log);

twitter_tweet

Get a simplified tweet by its ID

Arguments

Name	Type	Required	Description
pid	`string`	Yes	Tweet ID

Code Examples

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

import requests, json

payload = {
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "twitter_tweet",
    "arguments": {
      "pid": "VALUE"
    }
  },
  "id": 1
}
headers = {"x-api-key": "YOUR_API_KEY", "x-subscription-id": "YOUR_SUB_ID"}
response = requests.post("https://pressmonitor.ca/mcp", json=payload, headers=headers)
print(response.json())

const payload = {
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "twitter_tweet",
    "arguments": {
      "pid": "VALUE"
    }
  },
  "id": 1
};

fetch("https://pressmonitor.ca/mcp", {
  method: "POST",
  headers: {"x-api-key": "YOUR_API_KEY", "x-subscription-id": "YOUR_SUB_ID"},
  body: JSON.stringify(payload)
})
  .then(r => r.json())
  .then(console.log);

twitter_followers

Get simplified followers by numeric user ID

Arguments

Name	Type	Required	Description
user	`string`	Yes	Numeric user ID
count	`integer`	No	Number of results

Code Examples

curl -X POST \
  "https://pressmonitor.ca/mcp" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-subscription-id: YOUR_SUB_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "twitter_followers",
    "arguments": {
      "user": "VALUE",
      "count": 0
    }
  },
  "id": 1
}'

import requests, json

payload = {
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "twitter_followers",
    "arguments": {
      "user": "VALUE",
      "count": 0
    }
  },
  "id": 1
}
headers = {"x-api-key": "YOUR_API_KEY", "x-subscription-id": "YOUR_SUB_ID"}
response = requests.post("https://pressmonitor.ca/mcp", json=payload, headers=headers)
print(response.json())

const payload = {
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "twitter_followers",
    "arguments": {
      "user": "VALUE",
      "count": 0
    }
  },
  "id": 1
};

fetch("https://pressmonitor.ca/mcp", {
  method: "POST",
  headers: {"x-api-key": "YOUR_API_KEY", "x-subscription-id": "YOUR_SUB_ID"},
  body: JSON.stringify(payload)
})
  .then(r => r.json())
  .then(console.log);

twitter_followers_page

Get a page of followers with the pagination cursor.

Arguments

Name	Type	Required	Description
user	`string`	Yes	Numeric user ID
count	`integer`	No	Number of results
cursor	`string`	No	Pagination cursor

Code Examples

curl -X POST \
  "https://pressmonitor.ca/mcp" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-subscription-id: YOUR_SUB_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "twitter_followers_page",
    "arguments": {
      "user": "VALUE",
      "count": 0,
      "cursor": "VALUE"
    }
  },
  "id": 1
}'

import requests, json

payload = {
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "twitter_followers_page",
    "arguments": {
      "user": "VALUE",
      "count": 0,
      "cursor": "VALUE"
    }
  },
  "id": 1
}
headers = {"x-api-key": "YOUR_API_KEY", "x-subscription-id": "YOUR_SUB_ID"}
response = requests.post("https://pressmonitor.ca/mcp", json=payload, headers=headers)
print(response.json())

const payload = {
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "twitter_followers_page",
    "arguments": {
      "user": "VALUE",
      "count": 0,
      "cursor": "VALUE"
    }
  },
  "id": 1
};

fetch("https://pressmonitor.ca/mcp", {
  method: "POST",
  headers: {"x-api-key": "YOUR_API_KEY", "x-subscription-id": "YOUR_SUB_ID"},
  body: JSON.stringify(payload)
})
  .then(r => r.json())
  .then(console.log);

twitter_followings_page

Get a page of accounts a user follows (following) with the pagination cursor.

Arguments

Name	Type	Required	Description
user	`string`	Yes	Numeric user ID
count	`integer`	No	Number of results
cursor	`string`	No	Pagination cursor

Code Examples

curl -X POST \
  "https://pressmonitor.ca/mcp" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-subscription-id: YOUR_SUB_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "twitter_followings_page",
    "arguments": {
      "user": "VALUE",
      "count": 0,
      "cursor": "VALUE"
    }
  },
  "id": 1
}'

import requests, json

payload = {
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "twitter_followings_page",
    "arguments": {
      "user": "VALUE",
      "count": 0,
      "cursor": "VALUE"
    }
  },
  "id": 1
}
headers = {"x-api-key": "YOUR_API_KEY", "x-subscription-id": "YOUR_SUB_ID"}
response = requests.post("https://pressmonitor.ca/mcp", json=payload, headers=headers)
print(response.json())

const payload = {
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "twitter_followings_page",
    "arguments": {
      "user": "VALUE",
      "count": 0,
      "cursor": "VALUE"
    }
  },
  "id": 1
};

fetch("https://pressmonitor.ca/mcp", {
  method: "POST",
  headers: {"x-api-key": "YOUR_API_KEY", "x-subscription-id": "YOUR_SUB_ID"},
  body: JSON.stringify(payload)
})
  .then(r => r.json())
  .then(console.log);