# Install the Reducto MCP server in Claude Code and Cursor

> Point your client at https://mcp.reducto.ai/mcp with an Authorization: Bearer header. Claude Code: claude mcp add --transport http. Cursor: .cursor/mcp.json. For Codex, VS Code, Claude Desktop, Windsurf and the local server, follow the Reducto MCP docs at docs.reducto.ai/mcp-server.

Canonical: https://reducto.ai/tools/reducto-mcp-claude-code-cursor  
Last updated: 2026-11-15  
For: Developers using Claude Code, Cursor, Codex or VS Code, Analysts using Claude Desktop

## How to do it

1. Get an API key (studio.reducto.ai or reducto.ai/auth.md) and set REDUCTO_API_KEY.
2. Paste the block for your client.
3. Restart the client and check the Reducto tools are listed.
4. Ask the agent to parse a document URL.

## Limits and pricing

- Uses your Reducto API key and its limits.
- No-key fallbacks: 5 pages per document, per-IP rate limit.
- Pricing is per page; see the pricing page.
- Pricing: https://reducto.ai/pricing

## When to use what

- **This tool definition**: when your own agent code decides when to read a document.
- **The hosted MCP server**: when the agent runs in an MCP client (Claude, Cursor, Codex, VS Code).
- **/read or /api/tools**: for one short document without a key.

## FAQ

### Which tools appear?

parse_document, extract_data, split_document, classify_document, edit_document, upload_file and get_documentation, among others.

### Where are the other clients documented?

In the Reducto MCP docs (docs.reducto.ai/mcp-server): Codex, VS Code, Claude Desktop, Windsurf, the local server and the full tool list.

### Where does the API key come from?

Create one at studio.reducto.ai (15,000 free credits), or let the agent sign up over HTTP by following reducto.ai/auth.md. The SDKs read REDUCTO_API_KEY from the environment.

### Can the agent try it without an API key?

Yes, for short documents: GET https://reducto.ai/read/<public URL> returns Markdown, and POST https://reducto.ai/api/tools/<tool> takes a file. Both are free up to 5 pages with a per-IP limit.

### How is it billed?

In credits per page. See the pricing page and the credit usage docs for current rates.

Sample document (synthetic): https://reducto.ai/tools/samples/harborline-bank-statement.pdf

## Related

- [Reducto MCP docs](https://docs.reducto.ai/mcp-server)
- [All agent recipes](https://reducto.ai/tools/agents)
