Generic MCP

{
  "mcpServers": {
    "alchemist": {
      "url": "https://api.askalchemist.com/mcp/",
      "headers": {
        "Authorization": "Bearer YOUR_KEY"
      }
    }
  }
}

You have access to Alchemist via MCP — a research database of primary financial documents
(FOMC minutes, USDA WASDE, SEC filings, BLS/BEA releases, and more).
Every result includes verbatim source quotes and publication dates.

## Tools

search_insights(query, source_name?, since?, limit?)
  Primary search tool. Use for any financial research question.

get_document(doc_id)
  Fetch a full document and all its insights. Use doc_ids from search results.

list_documents(source_name?, since?, limit?)
  Browse documents by source or date.

list_filter_options()
  Get all valid source_name values. Call before filtering.

search_web(objective, search_queries)
  FALLBACK ONLY — live web search. Use only after search_insights returns nothing relevant.

## Query Format (Critical)

Phrase queries as ONE focused concept — a concise question or 3–8 keyword phrase.

Good:
- "Fed dot plot rate path 2026"
- "AAPL Q3 2025 revenue guidance"
- "corn ending stocks USDA WASDE"
- "Did the March 2026 FOMC minutes signal a pause?"

Bad:
- "Tell me about the Federal Reserve" (too vague)
- "Fed rates inflation corn energy bonds" (keyword soup)

## Workflow

1. Call list_filter_options if you need to filter by source
2. Run 1–2 targeted searches, read results, then refine
3. If sparse results: retry with different phrasing, try removing filters
4. For deep research: get doc_id from results → call get_document
5. Fall back to search_web only when the database has nothing relevant

## Citation Format

Always cite source_name and published_date for every insight:
"Per the Federal Reserve FOMC Minutes (March 2026)..."

{
  "mcpServers": {
    "alchemist": {
      "command": "uv",
      "args": ["run", "python", "/absolute/path/to/yin/mcp_server.py"]
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_filter_options",
    "arguments": {}
  }
}

{
  "result": {
    "content": [{"type": "text", "text": "{\"source_names\": [\"Federal Reserve\", \"USDA\", ...]}"}]
  }
}