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.1.0), io.veezee/reddit (1.1.0), and io.veezee/x-twitter (1.1.0). The server is a hosted service; this repo also ships a small stdio proxy (npx github:veezeehq/veezee-mcp) for clients that spawn a local command.

• Every call needs a free key, and minting one costs nothing: no signup, no card, no human. See Quickstart below. The free tier is 200 credits per IP per day across all platforms, cached data, first page only. Paying at https://veezee.io/upgrade credits the same key with a higher budget, realtime freshness, and full pagination.

• Website and docs: https://veezee.io

• Found a bug or a gap? Open an issue or write hello@veezee.io.

Run locally (stdio)

For MCP clients that spawn a local command instead of connecting to a URL:

npx github:veezeehq/veezee-mcp

The proxy connects to https://mcp.veezee.io/all and mints a free trial key on first run (no signup). Set VEEZEE_API_KEY to reuse one key across runs, and VEEZEE_MCP_URL to point at a single-platform mount. Docker: docker build -t veezee-mcp . && docker run -i veezee-mcp.

Related MCP server: riocloud-reader

Mounts

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

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)

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

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

Every mount

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

Quickstart

Every tool call needs a key, and getting one costs nothing. Mint one directly:

curl -s -X POST https://api.veezee.io/v1/keys/mint

That returns a vz_trial_... key with the same free-tier budget as before: 200 credits per IP per day, cached data, first page only. Drop it into your MCP client config as a bearer header, then reconnect. Example for /all (swap in /linkedin, /reddit, or /x for a single-platform mount):

{
  "mcpServers": {
    "veezee": {
      "url": "https://mcp.veezee.io/all",
      "headers": { "Authorization": "Bearer vz_trial_..." }
    }
  }
}

Don't want to mint a key by hand first? If your client supports MCP authorization (Claude Code, claude.ai connectors), just connect: the server answers unauthenticated requests with a sign-in challenge and the client opens a Veezee sign-in in your browser (email code, no password, no card). Clients without that support get a KEY_REQUIRED error whose message spells out the mint step (POST /v1/keys/mint) plus a mint_url. Either route, you get from zero to a working connection with no signup form and no card.

Paying at https://veezee.io/upgrade credits the same key, trial straight to flex; nothing to reconfigure. Realtime freshness and full pagination come with a paid balance.

Install

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

Claude Code:

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

Codex CLI:

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

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

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

VS Code (.vscode/mcp.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).

You can connect any of the clients above before you have a key: OAuth-capable clients sign in on first contact, and the rest get a KEY_REQUIRED error that spells out the mint step, as described in Quickstart; add the Authorization header once you have the key.

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).

Links

• Agent setup guide: https://veezee.io/agent-setup/prompt.md

• Operating rules for agents: https://veezee.io/AGENTS.md

• Pricing: https://veezee.io/pricing

• What we store and how keys are handled: https://veezee.io/trust

• Skills packs: https://github.com/veezeehq/veezee-skills