# Sofya MCP server

Web search, fetch, extract, and research for AI agents. Markdown output + AI-synthesized answers.

## Links
- Registry page: https://www.getdrio.com/mcp/co-sofya-sofya
- Website: https://sofya.co

## Install
- Endpoint: https://sofya.co/mcp
- Auth: Auth required by registry metadata

## Setup notes
- Remote header: Authorization (required; secret)
- The upstream registry signals required auth or secrets.
- Remote endpoint: https://sofya.co/mcp
- Header: Authorization

## Tools
- search - Search the web for current information on any topic. Returns extracted page content, not just snippets. Best for factual lookups, specific questions, or when you need a list of sources. For open-ended questions that need synthesis across many sources, use the research tool instead.

For news queries (current events, breaking news, politics, world events), set topic="news" to search news sources specifically. This returns recent articles with publication dates.

Set include_answer=true to get an AI-synthesized answer alongside results (adds 5 credits). This is the sweet spot for most agent tasks, e.g. basic + include_answer = 8 credits, much cheaper than a full 25-credit research call.

Returns: query, answer (if requested), results (array of {title, url, content, description, fetched, published_date}), search_depth, topic, elapsed_ms, credits_used, credits_remaining, altered_query.

Args:
    query: The search query
    search_depth: "basic" (default) for extracted page content (3 credits), "snippets" for SERP snippets only without page fetching (1 credit)
    max_results: Number of results (default 10, max 20)
    include_answer: Generate an AI answer that synthesizes the search results (adds 5 credits)
    include_domains: Only include results from these domains (max 10)
    exclude_domains: Exclude results from these domains (max 10)
    topic: "general" for web search, "news" for news articles. use "news" for current events, breaking news, politics, or any time-sensitive query
    freshness: Filter by recency - "day", "week", "month", "year", or "YYYY-MM-DD:YYYY-MM-DD" Endpoint: https://sofya.co/mcp
- fetch - Fetch one or more URLs and return their content as clean markdown. Use this to read articles, documentation, blog posts, or any page where you need the complete text, not just a snippet from search. Also supports PDF, DOCX, and other document formats. Costs 1 credit per URL. Max 10 URLs per request. Failed URLs are not charged.

Set include_raw_html=true to also get the raw HTML source in each result. Useful for inspecting embedded URLs, data attributes, iframes, or script tags that are stripped during markdown conversion. Returns null for non-HTML content (PDF, DOCX, etc.). Same cost.

Returns: results (array of {title, url, content, raw_html, published_time, success, error}), credits_used, credits_remaining.

Args:
    urls: List of URLs to fetch (max 10)
    include_raw_html: Include raw HTML source in each result (default false) Endpoint: https://sofya.co/mcp
- extract - Fetch a webpage and extract specific information using AI. Use this when you need structured data from a page (e.g. pricing, specs, contact info) rather than the raw content. Costs 5 credits.

Returns: content (the extracted text), url, credits_used, credits_remaining, usage (token counts).

Args:
    url: The URL to extract from
    prompt: What information to extract (e.g. "list all pricing tiers with features" or "extract the author name and publication date") Endpoint: https://sofya.co/mcp
- research - Perform comprehensive research on a topic. Decomposes your query into sub-queries, searches and reads multiple sources in parallel, then synthesizes a structured report with citations. Best for open-ended or comparative questions that need coverage from many angles. For simple factual lookups, use search instead (optionally with include_answer=true for cheap synthesis). Costs 25 credits.

Returns: query, report (structured markdown with citations), sources (array of {title, url, fetched}), sub_queries (the decomposed queries), credits_used, credits_remaining, usage (token counts).

Args:
    query: The research question or topic
    topic: "general" (default) or "news" (prioritize recent news articles)
    freshness: Filter by recency - "day", "week", "month", "year", or "YYYY-MM-DD:YYYY-MM-DD"
    max_sources: Maximum number of sources to use, 5-30 (default 20) Endpoint: https://sofya.co/mcp

## Resources
Not captured

## Prompts
Not captured

## Metadata
- Owner: co.sofya
- Version: 1.27.0
- Runtime: Streamable Http
- Transports: HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: May 27, 2026
- Source: https://registry.modelcontextprotocol.io