Official7 tools

by veezeehq

Reddit posts, comments, subreddits, and search for AI agents. No key needed to start.

Topics

ai-agentslinkedinmcpmcp-servermodel-context-protocol

Captured live from the server via tools/list.

reddit_search

Search all of Reddit by keywords. type picks the target: posts (default), comments (what people actually say about a product, problem, or brand -- unique to Reddit search), subreddits (find communities), users. Pass query as free text up to 256 characters; decompose broad topics into several narrower queries, since result depth per query is capped upstream around a few hundred results. sort applies to posts (relevance|top|new|hot|comment_count) and comments (relevance|top|new); range (past_hour..all_time) applies to posts only; both are rejected with INVALID_INPUT elsewhere. Costs 6 credits per page; a cursor page is a NEW call priced the same way. Returns one page of summaries (author, title or comment text, upvotes, comment_count, created_at, permalink, id) with a cursor; there is no server-side time window on comment search, so for monitoring filter on created_at yourself and poll with sort=new. Fetch full post bodies and discussion threads with reddit_get_post; read one community's feed with reddit_get_subreddit_posts. For high-volume recency sweeps across X instead, use x_search.

Parameters7

query	string	required	Free-text keywords, e.g. 'self hosted photo backup'. Not a URL; use reddit_resolve_url for URLs.
type	string	optional
sort	string	optional
range	string	optional
cursor	string	optional
freshness	string	optional
max_credits	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 256,
      "description": "Free-text keywords, e.g. 'self hosted photo backup'. Not a URL; use reddit_resolve_url for URLs."
    },
    "type": {
      "type": "string"
    },
    "sort": {
      "type": "string"
    },
    "range": {
      "type": "string"
    },
    "cursor": {
      "type": "string"
    },
    "freshness": {
      "type": "string"
    },
    "max_credits": {
      "type": "number"
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

reddit_get_subreddit

Fetch one subreddit's profile: title, description, subscriber and active-user counts, age, NSFW flag, and topics. subreddit_name is the name without the r/ prefix, e.g. 'selfhosted'; a full reddit.com URL also works. Set include_settings to also get the community rules and moderator list for +2 credits (useful before posting or judging moderation culture). Costs 4 credits base. Subscriber counts here are the standard sizing signal for market research. This tool does not return posts: read the feed with reddit_get_subreddit_posts, and discover subreddits you don't know by name with reddit_search type=subreddits.

Parameters4

subreddit_name	string	required	Subreddit name without the r/ prefix, e.g. 'selfhosted'. Full URLs are accepted and cleaned.
include_settings	boolean	optional
freshness	string	optional
max_credits	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "subreddit_name": {
      "type": "string",
      "description": "Subreddit name without the r/ prefix, e.g. 'selfhosted'. Full URLs are accepted and cleaned."
    },
    "include_settings": {
      "type": "boolean"
    },
    "freshness": {
      "type": "string"
    },
    "max_credits": {
      "type": "number"
    }
  },
  "required": [
    "subreddit_name"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

reddit_get_subreddit_posts

Fetch one page of posts from a single subreddit, the community-monitoring primitive. subreddit_name is the name without the r/ prefix. sort defaults to the subreddit's own front-page order (best); use sort=new for monitoring and top with a range for 'best of' research. Costs 4 credits per page; a cursor page is a NEW call priced the same way. Returns post summaries (title, author, upvotes, comment_count, created_at, permalink, id) with a cursor for older posts; bodies and discussions come from reddit_get_post with the returned ids. For keyword search across all of Reddit use reddit_search; this tool takes no query.

Parameters6

subreddit_name	string	required	Subreddit name without the r/ prefix, e.g. 'selfhosted'.
sort	string	optional
range	string	optional
cursor	string	optional
freshness	string	optional
max_credits	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "subreddit_name": {
      "type": "string",
      "description": "Subreddit name without the r/ prefix, e.g. 'selfhosted'."
    },
    "sort": {
      "type": "string"
    },
    "range": {
      "type": "string"
    },
    "cursor": {
      "type": "string"
    },
    "freshness": {
      "type": "string"
    },
    "max_credits": {
      "type": "number"
    }
  },
  "required": [
    "subreddit_name"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

reddit_get_user

Fetch one Reddit user's public profile: username, account age, karma, follower count, and description. username is the name without the u/ prefix, e.g. 'spez'; a full profile URL also works. Add up to 2 sections from comments|posts|subreddits at 2 credits each: comments and posts return that user's recent activity (first page), subreddits returns where they are active. Costs 4 credits base. Use this to profile loud voices found via reddit_search before quoting or engaging them. To find users by topic, use reddit_search type=users; this tool needs an exact username.

Parameters4

username	string	required	Reddit username without the u/ prefix, e.g. 'spez'. Full profile URLs are accepted and cleaned.
sections	array	optional
freshness	string	optional
max_credits	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "username": {
      "type": "string",
      "description": "Reddit username without the u/ prefix, e.g. 'spez'. Full profile URLs are accepted and cleaned."
    },
    "sections": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "freshness": {
      "type": "string"
    },
    "max_credits": {
      "type": "number"
    }
  },
  "required": [
    "username"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

reddit_get_post

Fetch full post content for up to 100 Reddit posts by their t3_ ids in one call -- the follow-up loop after reddit_search or reddit_get_subreddit_posts. Costs 4 credits for up to 10 ids, +1 credit per further 10 ids; every post comes back with its full body text. With exactly ONE id you may set detail to 'full' for +4 credits to also get the discussion tree (comments flattened in tree order with depth, about 200 per page, with a comments_cursor to continue), or pass comment_id (a t1_ id, also +4 credits) to fetch one specific comment in its post context. Post ids come from the other Reddit tools or from reddit_resolve_url on a post URL. Not for discovering posts; search first, then batch-fetch here.

Parameters7

post_ids	array	required
detail	string	optional
comment_id	string	optional
sort	string	optional
cursor	string	optional
freshness	string	optional
max_credits	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "post_ids": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "detail": {
      "type": "string"
    },
    "comment_id": {
      "type": "string"
    },
    "sort": {
      "type": "string"
    },
    "cursor": {
      "type": "string"
    },
    "freshness": {
      "type": "string"
    },
    "max_credits": {
      "type": "number"
    }
  },
  "required": [
    "post_ids"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

reddit_resolve_url

Identify what a Reddit URL points at before fetching it. Give any reddit.com or redd.it URL (share links, old.reddit.com, trailing params are fine); get back {type: subreddit|user|post|comment, id, handle, canonical_url}. Post URLs yield the t3_ id for reddit_get_post; comment permalinks yield the t1_ id; subreddit and user URLs yield the name for reddit_get_subreddit or reddit_get_user. Costs 2 credits and parses offline without fetching the page. Skip this tool when you already have a t3_/t1_ id, subreddit name, or username: the other Reddit tools accept those directly. Not for non-Reddit URLs; it returns INVALID_INPUT for those.

Parameters1

url

string

required

A Reddit URL, e.g. https://www.reddit.com/r/selfhosted/comments/1tbups6/... or https://redd.it/1tbups6.

Raw schema

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "A Reddit URL, e.g. https://www.reddit.com/r/selfhosted/comments/1tbups6/... or https://redd.it/1tbups6."
    }
  },
  "required": [
    "url"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_usage

Check your balance, plan, limits, and the last 10 charges (receipt ids included). Costs 0 credits and is exempt from the per-minute rate limit, so call it whenever you need to budget. The response includes upgrade_url (give it to your human when credits or plan limits block you; purchases credit this account directly with no login) and manage_url (give it to your human to change or cancel a paid plan in the Stripe billing portal). Trial accounts also get a claim_url that attaches an email so the account can be recovered if the key is lost. Requires an API key: keyless calls have no account, and each keyless response already reports its cost in the usage block. Not for fetching platform data.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

README.md5 KBView on GitHub

Veezee MCP server

LinkedIn, Reddit, and X (formerly Twitter) data for AI agents, over MCP or REST. This repo is the public home and issue tracker for the hosted servers on the official MCP Registry: io.veezee/linkedin (3.0.0), io.veezee/reddit (1.0.0), and io.veezee/x-twitter (1.0.0). The server is a hosted service; there is nothing to build or run from this repo.

No key needed to start: every data tool works keyless, under a shared budget of 20 credits per IP per day across all platforms, recent data only. Buy a key at https://veezee.io/upgrade for a higher budget; it's shown once on the confirmation page.
Website and docs: https://veezee.io
Found a bug or a gap? Open an issue or write hello@veezee.io.

Mounts

Four endpoints, all streamable-http, same auth and pricing:

mount	covers
`https://mcp.veezee.io/linkedin`	LinkedIn only (5 tools + `get_usage`)
`https://mcp.veezee.io/reddit`	Reddit only (6 tools + `get_usage`)
`https://mcp.veezee.io/x`	X (formerly Twitter) only (5 tools + `get_usage`)
`https://mcp.veezee.io/all`	Every platform (17 tools + `get_usage`)

Pick a single-platform mount when your agent only needs one platform: a smaller tool list is easier for the model to pick from correctly and costs less context per turn. Pick /all when one task spans platforms, e.g. a research brief that pulls LinkedIn, Reddit, and X signal on the same account, or a monitoring loop that watches more than one platform at once.

The 17 tools

LinkedIn (https://mcp.veezee.io/linkedin)

tool	what it does	credits
`linkedin_resolve_url`	identify a LinkedIn URL	2
`linkedin_get_profile`	get a person profile	4 base (2 sections included, +2/section, max 4)
`linkedin_search_people`	search people	10 base (10 results included, +1/10 more, max 30)
`linkedin_get_company`	get a company	4 base (+4 to resolve a new domain)
`linkedin_get_posts`	recent posts by a person or company	4/page (+4 to resolve a new domain)

Reddit (https://mcp.veezee.io/reddit)

tool	what it does	credits
`reddit_search`	search posts, comments, subreddits, or users	6/page
`reddit_get_subreddit`	get subreddit details	4 base (+2 for rules and moderators)
`reddit_get_subreddit_posts`	get a subreddit's posts	4/page
`reddit_get_user`	get a Reddit user	4 base (+2/section, max 2)
`reddit_get_post`	get posts by id, with an optional discussion thread	4 for up to 10 ids (+1/10 more, max 100; +4 for the full thread or one comment in context)
`reddit_resolve_url`	identify a Reddit URL	2

X, formerly Twitter (https://mcp.veezee.io/x)

tool	what it does	credits
`x_search`	search X (formerly Twitter)	6/page
`x_get_profile`	get an X profile	4
`x_get_tweets`	get an account's tweets	4/page
`x_get_tweet`	get one tweet with full metrics	4
`x_resolve_url`	identify an X URL	2

Every mount

tool	what it does	credits
`get_usage`	check credits and recent charges (needs a key)	0

Any tool call can set freshness: "realtime" for +2 credits to force a live fetch instead of cached data (needs a key). Full tool reference with schemas: https://veezee.io/docs

Keyless quickstart

No signup, no card, no key: the calls below work as-is. One example per platform.

LinkedIn — get a person profile:

json

{
  "method": "tools/call",
  "params": {
    "name": "linkedin_get_profile",
    "arguments": { "identifier": "williamhgates" }
  }
}

Reddit — search comments for what people say about a product:

json

{
  "method": "tools/call",
  "params": {
    "name": "reddit_search",
    "arguments": { "query": "notion alternative", "type": "comments" }
  }
}

X, formerly Twitter — get a profile:

json

{
  "method": "tools/call",
  "params": {
    "name": "x_get_profile",
    "arguments": { "identifier": "nasa" }
  }
}

Install

Examples below use /all; swap in /linkedin, /reddit, or /x for a single-platform mount.

Claude Code:

code

claude mcp add --transport http veezee https://mcp.veezee.io/all

Codex CLI:

code

codex mcp add veezee --url https://mcp.veezee.io/all

Cursor (.cursor/mcp.json or ~/.cursor/mcp.json):

json

{
  "mcpServers": {
    "veezee": { "url": "https://mcp.veezee.io/all" }
  }
}

VS Code (.vscode/mcp.json):

json

{
  "servers": {
    "veezee": { "type": "http", "url": "https://mcp.veezee.io/all" }
  }
}

claude.ai: Settings > Connectors > Add custom connector > https://mcp.veezee.io/all (or a single-platform mount).

More clients (Windsurf, Cline, Zed, plain REST), each snippet verified against the client's official docs: https://veezee.io/docs/clients

REST twin

Every tool has a REST route with identical semantics at https://api.veezee.io (contract: https://veezee.io/openapi.json). A typed TypeScript SDK and CLI ship as @veezee/sdk (docs: https://veezee.io/docs/sdk).

Install

Tools (7)

reddit_searchreddit_get_subredditreddit_get_subreddit_postsreddit_get_userreddit_get_postreddit_resolve_urlget_usage

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mcp.veezee.io/reddit

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "reddit": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.veezee.io/reddit"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

Topics

reddit_search

reddit_get_subreddit

reddit_get_subreddit_posts

reddit_get_user

reddit_get_post

reddit_resolve_url

get_usage

Veezee MCP server

Mounts

The 17 tools

Keyless quickstart

Install

REST twin

Links

Install

Remote endpoint