Core concepts
Insights
A single extracted finding from a document: a claim, a data point, or a directional statement. Each insight carries the exact quote it was derived from.
Documents
The primary source — FOMC minutes, WASDE, 10-K, CPI release, etc. Each document has many insights. You can retrieve a document and all its insights in one call.
Sources
The publishing organization — Federal Reserve, USDA, BLS, a company, a sell-side desk. Use source filters to scope searches to a specific institution.
Semantic search
Insights are indexed with HyDE embeddings. Queries work best as focused questions or 3–8-word keyword phrases, not keyword soup or conversational sentences.
Two ways to connect
| Method | Best for |
|---|---|
| MCP | AI agents and coding assistants (Claude, Cursor, Cline, Hermes). Zero boilerplate — the agent calls tools directly. |
| REST API | Production integrations, data pipelines, custom agents, non-MCP clients. |
What gets searched
Alchemist covers macro policy documents (Fed, ECB, BLS, BEA), agricultural reports (USDA), energy data (EIA), corporate filings (SEC EDGAR), and curated news from specialized sources. UseGET /api/documents/filters to see what’s in the database at any moment.