Does sofya-co/sofya-mcp work with Claude Desktop?

Yes. The README provides a Claude Desktop MCP configuration using the `npx` command, `sofya-mcp` package, and `SOFYA_API_KEY` environment variable.

What tools does sofya-co/sofya-mcp provide?

It provides `search`, `fetch`, `extract`, and `research` tools for web search, document retrieval, structured extraction, and cited multi-source research.

What environment variable does sofya-co/sofya-mcp require?

Set `SOFYA_API_KEY` to a Sofya API key. `SOFYA_BASE_URL` is optional and overrides the default Sofya API base URL.

Sofya MCP

web-searchdata-extractionresearchdocuments

Searches, fetches, extracts, and researches web content through the Sofya API over MCP.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "sofya-co-sofya-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "sofya-mcp"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Overview

sofya-co/sofya-mcp MCP server gives AI agents web search, URL fetching, structured extraction, and multi-source research tools. It runs locally over stdio and sends requests to the Sofya REST API using a Sofya API key. Use it when an agent needs full page content, clean document text, prompt-based extraction, or cited research rather than search snippets alone.

Use cases

Search the web for full page content

Fetch URLs and documents as clean Markdown

Extract structured fields from web pages

Research questions across multiple cited sources

Key features

Full-content web search

Markdown conversion for URLs and documents

Prompt-based structured extraction

Multi-source cited research

News, domain, and freshness search filters

Capabilities & Tool Schemas (4)Self-reported

Inspect callable tools, capabilities, and parameters exposed to AI agents by Sofya MCP.

search

Search the web and get extracted page content (not just snippets). Supports `news` topic, domain filters, freshness, and optional AI-synthesized `answer`.

fetch

Fetch up to 10 URLs as clean markdown. Also handles PDF, DOCX, and more.

extract

Fetch a page and pull specific structured info using AI.

research

Decompose a question into sub-queries, read many sources in parallel, and synthesize a cited report.

How Sofya MCP works

What sofya-co/sofya-mcp MCP server does

sofya-co/sofya-mcp MCP server exposes four Sofya web capabilities through the Model Context Protocol: search, fetch, extract, and research. The tools are intended for agents that need to inspect source pages and documents, not just receive search-result snippets.

Search returns extracted page content and supports news-focused queries, domain restrictions, freshness settings, and an optional AI-generated answer. Fetch converts up to 10 supplied URLs into clean Markdown and can process formats such as PDF and DOCX. Extract combines page retrieval with an AI instruction to return targeted, structured information. Research breaks a question into smaller searches, reads multiple sources in parallel, and produces a report with citations.

How it works

The package is a local stdio MCP server and acts as a thin client for the Sofya REST API. An MCP-compatible client starts the Node.js process, which uses the configured Sofya API key to make requests. The tool definitions match Sofya's hosted MCP interface, including tool names, parameters, and defaults.

Each operation consumes Sofya credits according to the README: search uses 1–3 credits, with 5 additional credits when an answer is requested; fetch uses 1 credit per URL; extract uses 5 credits; and research uses 25 credits. These costs are associated with the Sofya API rather than with the local process itself.

Setup and configuration

Install is not required for a direct run. With Node.js 18 or newer and a Sofya API key, launch sofya-co/sofya-mcp MCP server with SOFYA_API_KEY=ay_live_... npx -y sofya-mcp. The key is required and uses the ay_live_... format shown in the project documentation.

For MCP clients, configure a stdio server whose command is npx, with -y and sofya-mcp as arguments. Pass SOFYA_API_KEY in the process environment. The README gives configurations for Claude Desktop, Cursor, Windsurf, VS Code, Claude Code, and Codex. SOFYA_BASE_URL can optionally replace the default https://sofya.co API base URL. Command-line options for the API key and base URL take precedence over environment variables.

Tools and capabilities

search: Search the web with optional news topic, domain, freshness, and synthesized-answer settings.
fetch: Retrieve as many as 10 URLs per request as Markdown, including supported PDF and DOCX content.
extract: Ask the service to identify specific structured information from a page.
research: Run decomposed, parallel source searches and return a cited synthesized report.

Limitations and notes

The local package requires a Sofya API key and depends on the Sofya service for its web results and processing. API usage consumes credits, with research costing substantially more than individual search or fetch operations. The project requires Node.js 18 or later.

The package should not be confused with Sofya's hosted MCP endpoint at https://sofya.co/mcp. That endpoint uses Bearer authentication and does not require installing the local package; sofya-co/sofya-mcp MCP server is the option documented for local stdio execution. The README identifies the project license as MIT.

Read the full README →View source on GitHub →

Related MCP Servers

View all in Social Media View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

Last commit

2mo ago

Most recent push to the default branch.

Tools exposed

Callable tools this server registers over MCP.

Directory activity

4 views

Config copies, upvotes, and views on AllMCPs.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Sofya MCP

Install Node.js 18 or newer, then run `SOFYA_API_KEY=ay_live_... npx -y sofya-mcp`. The package can run directly without a separate installation.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/sofya-co-sofya-mcp?style=directory)](https://allmcps.com/mcp/sofya-co-sofya-mcp)

HTML Embed

<a href="https://allmcps.com/mcp/sofya-co-sofya-mcp"><img src="https://allmcps.com/api/badge/sofya-co-sofya-mcp?style=directory" alt="Sofya MCP on AllMCPs" /></a>

Technical Specs & Signals

CategorySocial Media

PricingBring your own API key (usage-based cost)

8/9 checks healthy over the last 31d

56Quality signal: Good · 56/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools28/30

Adoption & activity3/15

Community engagement1/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 16d ago via OSV.dev · sofya-mcp (npm)

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 🌐 Social Media →Best MCP servers for Social Media →Alternatives to Sofya MCP →Install in Claude Desktop Install in Cursor Install in VS Code