# Sofya

Adds four read-only tools to your agent: web search with full page content, URL-to-markdown fetching, structured extraction, and cited research reports.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 2
- Author: sofya-co
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/sofya-co/sofya-mcp
- Updated: 2026-10-05
- HTML: https://affpapa.org/en/nevibecode/mcp/sofya

## What it does

Sofya speaks Model Context Protocol and exposes four tools. `search` returns extracted page content rather than snippets, with domain, freshness and `news` filters plus an optional AI-written answer. `fetch` converts up to 10 URLs to clean markdown and reads PDF, DOCX, XLSX, PPTX and EPUB along the way. `extract` pulls a specific structure out of a page using AI, and `research` splits a question into sub-queries, reads sources in parallel and writes a report with citations.

Two ways to connect. The hosted endpoint at `https://sofya.co/mcp` takes your key as a Bearer token; the same server is registered in the MCP registry as `co.sofya/sofya`. Or run the `sofya-mcp` package locally over stdio with `npx` — it wraps the Sofya REST API and mirrors the hosted tools. The local route needs Node.js 18+.

Either way you need a Sofya API key in the `ay_live_...` format. Calls draw on credits: 2 per URL for `fetch`, 10 for `extract`, 50 for `research`, and 1–2 for `search` plus 10 when you ask for a synthesized answer. Eligible GitHub accounts receive 2,000 free credits each month.

## Requirements
- Remote server: `https://sofya.co/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http sofya https://sofya.co/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add sofya --url https://sofya.co/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "sofya": {
            "url": "https://sofya.co/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "sofya": {
            "type": "http",
            "url": "https://sofya.co/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http sofya https://sofya.co/mcp
```

## When to use it
- pull full page text instead of search snippets
- turn a PDF or DOCX into readable markdown
- extract a table or field list from someone else's page
- build a sourced overview of a broad question
- check what news outlets published on a topic this week

## Example prompts
- Search the web for the latest Node.js LTS release notes and show me the page content
- Fetch this PDF and summarize it

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47577
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43902

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md