MCP

Telegram MCP Server

Telegram has more than 1 billion monthly active users sharing messages, channels, groups, voice notes, bots, and media, making it important for direct distribution, community management, and fast-moving news audiences.

MCP Version: 1.0.0 7 MCP Tools Authentication

Base URL

https://mcp.pressmonitor.ca/mcp

Authentication

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

Authorization: Bearer YOUR_TOKEN

bot_info

Arguments

Name	Type	Required	Description
username	`string`	Yes

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": "bot_info",
    "arguments": {
      "username": "VALUE"
    }
  },
  "id": 1
}'

import requests, json

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

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

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

channel_info

Arguments

Name	Type	Required	Description
username	`string`	Yes

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": "channel_info",
    "arguments": {
      "username": "VALUE"
    }
  },
  "id": 1
}'

import requests, json

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

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

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

get_messages

Arguments

Name	Type	Required	Description
username	`string`	Yes
offset	`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": "get_messages",
    "arguments": {
      "username": "VALUE"
    }
  },
  "id": 1
}'

import requests, json

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

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

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

group_info

Arguments

Name	Type	Required	Description
username	`string`	Yes

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": "group_info",
    "arguments": {
      "username": "VALUE"
    }
  },
  "id": 1
}'

import requests, json

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

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

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

search

Arguments

Name	Type	Required	Description
keyword	`string`	Yes

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": "search",
    "arguments": {
      "keyword": "VALUE"
    }
  },
  "id": 1
}'

import requests, json

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

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

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

search_hashtag

Arguments

Name	Type	Required	Description
hashtag	`string`	Yes
offset	`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": "search_hashtag",
    "arguments": {
      "hashtag": "VALUE"
    }
  },
  "id": 1
}'

import requests, json

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

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

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

user_info

Arguments

Name	Type	Required	Description
username	`string`	Yes

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_info",
    "arguments": {
      "username": "VALUE"
    }
  },
  "id": 1
}'

import requests, json

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

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

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