OpenClaw

Step 1: Install or update Alchemist MCP

If Alchemist MCP already exists in your OpenClaw config, uninstall it first or update the
endpoint below. Run this command in your terminal:

openclaw mcp add alchemist \
  --url https://api.askalchemist.com/mcp/ \
  --transport streamable-http \
  --header Authorization="Bearer YOUR_KEY"


Step 2: Add the Alchemist skill

Save this file to ~/.openclaw/skills/alchemist-research/SKILL.md

---
name: alchemist-research
description: Financial research using the Alchemist database. Searches thousands of pre-processed primary source documents — FOMC minutes, USDA WASDE reports, SEC filings, BLS/BEA data releases — and returns citable insights with verbatim source quotes. Use for any macro, earnings, regulatory, or commodity research question.
context: fork
---

# Alchemist Financial Research

## Primary Tool

Always use `alchemist__search_insights` first for any financial research question.
Do NOT jump to web search before trying `alchemist__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)

## Tool Names in OpenClaw

OpenClaw namespaces MCP tools with double underscores:
- alchemist__search_insights — primary search
- alchemist__get_document — fetch full doc + all insights
- alchemist__list_documents — browse by source/date
- alchemist__list_filter_options — get valid source_name values
- alchemist__search_web — fallback live web search

## Workflow

1. Call `alchemist__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 `alchemist__get_document`
5. Fall back to `alchemist__search_web` ONLY after search returns nothing relevant

## Token Isolation

Never run large searches in the main context. Spawn a subagent:
- Subagent runs the search internally
- Subagent distills results into compact output
- Subagent returns findings to main context
- Main context stays clean regardless of result volume

## 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 OpenClaw

Run: openclaw mcp reload

openclaw mcp set alchemist '{"url":"https://api.askalchemist.com/mcp/","transport":"streamable-http","headers":{"Authorization":"Bearer YOUR_KEY"}}'

{
  tools: {
    allow: ["alchemist__*"]
  }
}