Cursor

Step 1: Add Alchemist to your Cursor MCP config

Create or update .cursor/mcp.json in your project root with this content:

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


Step 2: Add the Alchemist Cursor Rule

Create .cursor/rules/alchemist-research.mdc with this content:

---
description: Financial research using the Alchemist database. Searches primary source documents — FOMC minutes, USDA WASDE, SEC filings, BLS/BEA data releases — and returns citable insights with verbatim source excerpts. Apply for any macro, earnings, regulatory, or commodity research question.
alwaysApply: false
---

# Alchemist Financial Research

## Primary Tool

Always use `search_insights` first for any financial research question.
Do NOT jump to `search_web` before trying `search_insights`.

## Query Format (Critical)

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

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

Bad:
- "Tell me about the Federal Reserve and interest rates" (conversational wrapper)
- "Fed rates inflation corn energy bonds" (multi-theme keyword soup)

## Workflow

1. Call `list_filter_options` if you need to filter by source name
2. Run 1–2 targeted searches, read results, then refine
3. If sparse results: retry with different phrasing or remove filters
4. For deep research: get `doc_id` from search results → call `get_document`
5. Fall back to `search_web` ONLY after `search_insights` returns nothing relevant

## Citation Format

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

## Output Format

Return:
1. Key findings — one insight per line, attributed to source + date
2. Sources — document URL + publication date
3. Notes — gaps, conflicts, or uncertainty


Step 3: Reload Cursor

Ask the user to open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and run
"Developer: Reload Window" to activate the new MCP connection.

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