# Sofya

> Web search, fetch, extract, and research API for AI agents. One API key, four tools, clean markdown output.

Sofya gives AI agents four web tools via REST API and MCP:

- **Search**: Web search returning full page content, not just snippets. 1-3 credits (+5 with AI answer).
- **Fetch**: Convert any URL to clean markdown. Supports pages, PDFs, DOCX. 1 credit.
- **Extract**: AI-powered structured data extraction from any page. 5 credits.
- **Research**: Multi-source deep research with AI synthesis and citations. 25 credits.

Base URL: https://sofya.co
MCP endpoint: https://mcp.sofya.co/mcp
Rate limit: 10 requests/second per API key.

## Docs

- [API Documentation](https://sofya.co/docs): Full REST API reference with examples
- [SKILL.md](https://sofya.co/SKILL.md): AI-readable skill file with complete tool definitions and examples
- [Pricing](https://sofya.co/pricing): Credit costs, tiers, and FAQ

## Endpoints

- [POST /v1/search](https://sofya.co/docs#search): Search the web. Returns extracted page content. 1-3 credits depending on depth (snippets/basic). Add include_answer for AI synthesis (+5 credits).
- [POST /v1/fetch](https://sofya.co/docs#fetch): Fetch any URL as clean markdown. 1 credit.
- [POST /v1/extract](https://sofya.co/docs#extract): Fetch a page and extract specific info with AI. 5 credits.
- [POST /v1/research](https://sofya.co/docs#research): Deep research on a topic. Decomposes query, searches multiple sources, synthesizes report with citations. 25 credits.
- [GET /v1/status](https://sofya.co/v1/status): Public endpoint health (no auth). Returns overall status, per-endpoint latency, recent incidents.
- [GET /v1/updates](https://sofya.co/v1/updates): Public product changelog (no auth). Returns user-visible changes newest first.

## MCP Setup

- [Claude Code](https://sofya.co/docs#mcp): `claude mcp add --transport http sofya https://mcp.sofya.co/mcp --header "Authorization: Bearer ay_live_..."`
- [Cursor](https://sofya.co/docs#mcp): Add to ~/.cursor/mcp.json
- [Codex](https://sofya.co/docs#mcp): Add to ~/.codex/config.toml
- [Windsurf](https://sofya.co/docs#mcp): Add to ~/.codeium/windsurf/mcp_config.json
- [VS Code Copilot](https://sofya.co/docs#mcp): Add to .vscode/mcp.json

## Optional

- [Dashboard](https://sofya.co/dashboard): Manage API key, credits, and usage
- [Playground](https://sofya.co/playground): Try the API live in your browser
- [Status](https://sofya.co/status): Real-time API health and latency