# RedditMCP

RedditMCP is an MCP-first Reddit integration. It connects a user-authorized
Reddit OAuth account and exposes one durable operation catalog through MCP,
HTTP jobs, the TypeScript SDK, and the CLI.

## Discover

- MCP endpoint: https://redditmcp.com/mcp
- MCP resource metadata: https://redditmcp.com/.well-known/oauth-protected-resource
- Operation catalog: https://redditmcp.com/operations
- Full guide: https://redditmcp.com/llms-full.txt
- Human signup: https://redditmcp.com/sign-up

## MCP

POST JSON-RPC 2.0 messages to https://redditmcp.com/mcp. Supported methods are initialize,
tools/list, and tools/call. Use Authorization: Bearer <token> for account tools.
The catalog includes all neighboring reddit-universal-scraper HTTP surfaces.
Use redditmcp.reddit.connect to authorize an account, then call Reddit catalog
tools such as reddit.search, reddit.listing, and reddit.scraper.posts.list.

## Connect

1. Authenticate and select a tenant with X-RedditMCP-Tenant when needed.
2. POST https://redditmcp.com/v1/reddit/accounts.
3. POST https://redditmcp.com/v1/reddit/accounts/{id}/auth-intents with
   {"mode":"provider_oauth"}.
4. Open connect_url, approve Reddit OAuth, then poll GET
   https://redditmcp.com/v1/reddit/status until active.

## Safety

Read tools are the default. Comment/proof mutations require confirmed:true.
Raw query, proof, and evidence operations also require operator authority.