sofya-mcp
MCP server for Sofya - web search, fetch, extract, and deep research for AI agents, exposed over the Model Context Protocol.
Potencialize seu agente
A URL do próprio publicador. Não é um endpoint do PlugMCP.
Host a copy with our keys and logs.
https://mcp.sofya.co/mcpO botão do Claude acima abre o Claude com o nome e a URL preenchidos. Você ainda precisa confirmar lá.
claude mcp add --transport http co.sofya-sofya https://mcp.sofya.co/mcpRun in a terminal.
{ "mcpServers": { "co.sofya-sofya": { "command": "npx", "args": [ "-y", "mcp-remote", "https://mcp.sofya.co/mcp" ] } }}claude_desktop_config.json
URL remota ou um comando na sua máquina? Como as duas instalações diferem
Rodar no PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
AbrirDo publicador
MCP server for Sofya - web search, fetch, extract, and deep research for AI agents, exposed over the Model Context Protocol.
Web search, fetch, extract, and research for AI agents. Markdown output + AI-synthesized answers.
Use it either way:
https://sofya.co/mcp with your API key as a Bearer token. This is the server listed in the MCP registry as co.sofya/sofya.sofya-mcp package over stdio. It is a thin wrapper around the Sofya REST API with the same tools.All four tools are read-only. Eligible GitHub accounts get 2,000 free credits a month.
Get an API key at sofya.co (keys look like ay_live_...), then point your client at the hosted endpoint.
VS Code / GitHub Copilot (.vscode/mcp.json):
{
"servers": {
"sofya": {
"type": "http",
"url": "https://sofya.co/mcp",
"headers": { "Authorization": "Bearer ay_live_..." }
}
}
}
Claude Code:
claude mcp add --transport http sofya https://sofya.co/mcp --header "Authorization: Bearer ay_live_..."
Cursor (~/.cursor/mcp.json):
{
"mcpServers": {
"sofya": {
"url": "https://sofya.co/mcp",
"headers": { "Authorization": "Bearer ay_live_..." }
}
}
}
Then ask your agent things like "search for the latest Node.js LTS release notes", "fetch this PDF and summarize it", or "research how the EU AI Act treats open-weight models". Full API docs: sofya.co/docs.
ay_live_...)Run it directly with npx - no install needed:
SOFYA_API_KEY=ay_live_... npx -y sofya-mcp
claude mcp add sofya --env SOFYA_API_KEY=ay_live_... -- npx -y sofya-mcp
Add this to your MCP config (e.g. claude_desktop_config.json, or .cursor/mcp.json):
{
"mcpServers": {
"sofya": {
"command": "npx",
"args": ["-y", "sofya-mcp"],
"env": {
"SOFYA_API_KEY": "ay_live_..."
}
}
}
}
Add it with the Codex CLI:
codex mcp add sofya --env SOFYA_API_KEY=ay_live_... -- npx -y sofya-mcp
Or edit ~/.codex/config.toml directly. Note Codex puts environment variables in
a nested [mcp_servers.<name>.env] table:
[mcp_servers.sofya]
command = "npx"
args = ["-y", "sofya-mcp"]
[mcp_servers.sofya.env]
SOFYA_API_KEY = "ay_live_..."
Then run /mcp inside Codex to confirm the server is connected.
CLI flags --api-key and --base-url take precedence over the env vars.
Run npx sofya-mcp --list-tools to print the tool schemas, or --help for options.
git clone https://github.com/sofya-co/sofya-mcp.git
cd sofya-mcp
npm install # also builds via the prepare script
npm run build # compile TypeScript to build/
npm run watch # recompile on change
npm run inspector # debug with @modelcontextprotocol/inspector
The server is a single file, src/index.ts. Tool definitions
mirror Sofya's hosted MCP server exactly (same names, parameters, and defaults).
MIT - see LICENSE.
Web search, fetch, extract, and research for AI agents. Markdown output + AI-synthesized answers.
{ "mcpServers": { "co.sofya-sofya": { "url": "https://mcp.sofya.co/mcp", "headers": {} } }}Ferramentas
Ainda não há lista de ferramentas. Servidores remotos recebem uma após a primeira verificação de saúde.
Perguntas frequentes
Copie nesta página a configuração http para Cursor, Claude Desktop, Claude Code ou VS Code. Ela usa a instalação do publicador, não um proxy do PlugMCP.
Este registro não lista nenhuma variável de ambiente obrigatória.
Sofya é acessado por HTTP.
Última verificação: 2026-11-18. Web search, fetch, extract, and research for AI agents. Markdown output + AI-synthesized answers.