threadapi runs a remote MCP server. There’s nothing to install: point your client at the URL, then sign in to threadapi when the client asks, or send an API key.
| URL | https://api.threadapi.dev/mcp |
| Transport | Streamable HTTP |
| Auth | OAuth sign-in, or Authorization: Bearer <YOUR_API_KEY> |
| Billing | Tool calls cost the same as the REST routes. Connecting and listing tools is free. |
No account yet? An agent can create one for its user: see Agent sign-up.
Tools
| Tool | What it does | Credits |
|---|---|---|
get_reddit_post |
A raw Reddit post with its full comment tree as pristine Markdown (default) or raw JSON. Zero AI summarization; delivers full ground-truth content. Arguments: post (URL, comment permalink or ID), comment and context to focus on one comment, max_comments (default 200), format (markdown or json), digest (boolean, default false). |
1 for up to 500 comments, +1 per further 100 |
get_reddit_items |
Up to 100 raw posts by ID (t3_ or bare ID) or URL via fast bulk lookup. Arguments: ids (comma-separated). |
1 |
list_subreddit_posts |
Hot, new, top, rising or controversial posts. Arguments: subreddit, sort, time, limit, after, nsfw. |
1 |
get_subreddit |
A subreddit’s description, subscribers and rules. Arguments: subreddit. |
1 |
get_reddit_user |
A user’s karma and badges, and with include their recent posts or comments. Arguments: name, include. |
1, or 2 with include |
search_reddit |
Posts, comments, subreddits or users matching a query. Supports direct comment search without CDN blocks. Arguments: query, type (post, comment, subreddit or user), subreddit, sort, time, limit, after, nsfw. |
1 |
create_monitor |
Creates a new keyword monitor on public Reddit posts and comments. Scans the real-time Reddit firehose. Arguments: name, keywords (array of strings, 1-20), exclude, subreddits, posts, comments, nsfw, webhook_url, webhook_kind. |
10 credits / day |
update_monitor |
Updates an existing monitor’s settings, keywords, subreddits, or webhook. Pass webhook_url: "" to remove an existing webhook. Arguments: monitor_id, name, keywords, exclude, subreddits, posts, comments, nsfw, webhook_url, webhook_kind. |
0 |
pause_monitor |
Pauses an active keyword monitor. Stops scanning and stops daily charges at once. Arguments: monitor_id. |
0 |
resume_monitor |
Resumes a paused keyword monitor and restarts scanning. Charges 10 credits for 1 day. Arguments: monitor_id. |
10 credits / day |
delete_monitor |
Permanently deletes a keyword monitor and stops daily charges at once. Arguments: monitor_id. |
0 |
list_monitors |
Lists all active keyword monitors on your account, with their IDs, status, keywords, subreddits, and match counts. | 0 |
get_monitor_matches |
Matches detected by one of your monitors in compact text format. Arguments: monitor_id, order (oldest default or newest), after (cursor for oldest), before (cursor for newest), limit (default 100). |
0 |
Errors come back as tool errors with a hint for the model, and cost nothing.
Resources
Read-only context providers exposed through MCP URIs:
| Resource URI Template | MIME Type | Description |
|---|---|---|
reddit://post/{id} |
text/markdown |
Direct markdown representation of a raw Reddit post and its full comment tree. |
reddit://r/{subreddit}/hot |
text/plain |
Top hot posts from a subreddit in JSON format. |
Client Setup
Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (project-specific):
{
"mcpServers": {
"threadapi": {
"url": "https://api.threadapi.dev/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}Add to claude_desktop_config.json:
{
"mcpServers": {
"threadapi": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-fetch", "https://api.threadapi.dev/mcp"]
}
}
}Run in your terminal:
claude mcp add --transport http threadapi https://api.threadapi.dev/mcpAdd to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"threadapi": {
"serverUrl": "https://api.threadapi.dev/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}Install the Model Context Protocol extension, then add to your settings:
{
"mcp": {
"servers": {
"threadapi": {
"type": "http",
"url": "https://api.threadapi.dev/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
}