Skip to main content
The Alchemist MCP server exposes five tools. All are read-only. Endpoint: https://api.askalchemist.com/mcp/
Auth: Authorization: Bearer alch_YOUR_KEY
Transport: Streamable HTTP (MCP 2025)

​
search_insights

The primary research tool. Use this first for any financial question. Why search_insights first? Insights are embedded with HyDE — each insight stores both its text and a set of hypothetical questions it can answer. This makes keyword-adjacent queries work surprisingly well. It’s faster and cheaper than a web search, and every result carries a verbatim source quote.

​
Parameters

NameTypeRequiredDescription
querystringYesResearch query. One focused concept: a concise question or 3–8 keyword phrase.
source_namestringNoPartial match filter on the publishing organization (e.g. "Federal Reserve", "USDA", "BLS"). Use list_filter_options to see all valid values.
sincedateNoOnly return insights from documents published on or after this date (YYYY-MM-DD).
limitintegerNoMax results. Default 20.

​
Query format

PatternExample
Concise question"Did the March 2026 FOMC minutes signal a pause?"
Keyword phrase"Fed dot plot 2026 rate path"
Entity + metric"AAPL 2025 revenue guidance"
Theme + source"corn ending stocks USDA"
Avoid: conversational wrappers ("tell me about..."), question padding ("Can you explain..."), multi-theme lists ("Fed rates inflation energy corn").

​
Response

{
  "insights": [
    {
      "insight_id": "ins_01jwx...",
      "title": "Fed median dot unchanged at 3.875% for end-2026",
      "insight": "The March 2026 SEP showed the median federal funds rate projection for year-end 2026 held at 3.875%, unchanged from December 2025.",
      "excerpts": [
        "The median projection for the federal funds rate at the end of 2026 remained at 3.875 percent."
      ],
      "doc_id": "doc_01jww...",
      "doc_title": "FOMC SEP — March 2026",
      "source_url": "https://federalreserve.gov/monetarypolicy/files/...",
      "source_name": "Federal Reserve",
      "published_date": "2026-03-20",
      "score": 0.92
    }
  ]
}

​
get_document

Retrieve a full document and all its extracted insights by doc_id. Use this for deep research after search_insights has surfaced a relevant document — it gives you the complete set of insights extracted from that document, not just the ones that matched your query.

​
Parameters

NameTypeRequiredDescription
doc_idstringYesDocument ID from search_insights or list_documents results.

​
Response

{
  "document": {
    "doc_id": "doc_01jww...",
    "document_url": "https://federalreserve.gov/...",
    "article_title": "FOMC Minutes — March 18–19, 2026",
    "summary": "The March 2026 FOMC minutes detail committee deliberations on the pace of rate adjustments...",
    "source_name": "Federal Reserve",
    "authors": [],
    "published_date": "2026-04-09",
    "extracted_at": "2026-04-09T14:23:00Z",
    "extraction_status": "complete"
  },
  "insights": [
    {
      "insight_id": "ins_01jwx...",
      "title": "...",
      "insight": "...",
      "excerpts": ["..."]
    }
  ]
}

​
list_documents

Browse available documents with optional filters.

​
Parameters

NameTypeRequiredDescription
source_namestringNoPartial match on publishing organization name.
sincedateNoOnly documents published on or after this date (YYYY-MM-DD).
limitintegerNoMax results. Default 50.

​
Response

{
  "documents": [
    {
      "doc_id": "doc_01jww...",
      "document_url": "https://...",
      "article_title": "FOMC Minutes — March 18–19, 2026",
      "summary": "...",
      "source_name": "Federal Reserve",
      "published_date": "2026-04-09",
      "extraction_status": "complete"
    }
  ]
}

​
list_filter_options

Return all valid source_name values currently in the database. Call this before passing a source_name filter to search_insights or list_documents — source names must match exactly (case-insensitive partial match).

​
Parameters

None.

​
Response

{
  "source_names": [
    "Federal Reserve",
    "USDA",
    "Bureau of Labor Statistics",
    "Bureau of Economic Analysis",
    "U.S. Energy Information Administration",
    "SEC EDGAR"
  ]
}

​
search_web

Live web search via Parallel.ai. Fallback only — use after search_insights returns zero or only tangentially-relevant results. search_insights is always preferred: faster, no per-call variable cost, and every result has citation provenance.

​
Parameters

NameTypeRequiredDescription
objectivestringYesSelf-contained sentence describing the research goal. Must name the key entity or topic.
search_queriesstring[]Yes2–3 diverse keyword queries (3–6 words each). Vary entities, synonyms, and angles. Never use full sentences or site: operators.

​
Example

{
  "objective": "Find the latest consensus estimate for US core CPI in June 2026.",
  "search_queries": [
    "US core CPI June 2026 estimate",
    "CPI consensus forecast June 2026",
    "inflation expectations June 2026 Bloomberg"
  ]
}

​
Response

{
  "search_id": "ws_01abc...",
  "results": [
    {
      "url": "https://...",
      "title": "...",
      "publish_date": "2026-06-10",
      "excerpts": ["..."]
    }
  ]
}