Cafecito API Overview
Overview
Browse the interactive reference for each Cafecito API. Pick a product below to explore its endpoints, request/response schemas, and try calls directly from the playground.
There is no official SDK. Authenticate REST and MCP with Authorization: Bearer. Health routes are public and are not MCP tools.
Beans: Beans is a public-information discovery API for news, blogs, financial and earnings reports, litigation and lawsuits, official statements, research, technical documents, and related coverage context.
Espresso: Espresso is a market and business intelligence API for discovering market actions, signals, and tracing concrete evidence.
| API | Description |
|---|---|
| Beans API | Read-only publisher Articles, Sources, Stories, feeds, mentions, and discovery vocabularies. MCP: https://api.cafecito.tech/beans/mcp. |
| Espresso API | Read-only Events, Signals, evidence, and intelligence Sources. MCP: https://api.cafecito.tech/espresso/mcp. |
Need a key?
All authenticated endpoints require an API key. See the API Keys guide. One key works across live REST APIs and both MCP servers.
Intent to route
Start from what the user asked. Then open the matching reference, or call the matching MCP tool (MCP and AI agents). For publisher coverage followed by structured evidence, use Cross-product workflow.
| User intent | Product | REST | MCP tool |
|---|---|---|---|
| Service up? | Either | GET /beans/health or GET /espresso/health (no key) | (not exported) |
| Latest publisher Articles | Beans | GET /beans/articles/latest | getLatestArticles |
| Latest news only | Beans | GET /beans/news/latest | getLatestArticles with content_type=news |
| Top headlines / trending Articles | Beans | GET /beans/news/top-headlines, GET /beans/articles/trending | getTopHeadlines, getTrendingArticles |
| Trending news only | Beans | GET /beans/news/trending | getTrendingArticles with content_type=news |
| Search publisher Articles | Beans | GET /beans/articles/search | searchArticles |
| One Article, similar, mentions | Beans | GET /beans/articles/{id}, /similar, /mentions | getArticle, getSimilarArticles, getArticleMentions |
| Stories and member Articles | Beans | GET /beans/stories, GET /beans/stories/{id}, GET /beans/stories/{id}/articles | listStories, getStory, listStoryArticles |
| Publisher Sources | Beans | GET /beans/sources, GET /beans/sources/{id} | listSources, getSource |
| Beans filter vocabularies | Beans | GET /beans/categories, /entities, /regions, /sentiments | listCategories, listEntities, listRegions, listSentiments |
| What happened (Events) | Espresso | GET /espresso/events, GET /espresso/events/{event_id} | searchEvents, getEvent |
| Event evidence | Espresso | GET /espresso/events/{event_id}/evidence | getEventEvidence |
| Event ↔ Signal links | Espresso | GET /espresso/events/{event_id}/signals, GET /espresso/signals/{signal_id}/events | getEventSignals, getSignalEvents |
| Meaning, impact, outlook (Signals) | Espresso | GET /espresso/signals, GET /espresso/signals/{signal_id} | searchSignals, getSignal |
| Intelligence Sources | Espresso | GET /espresso/sources, GET /espresso/sources/{source_id} | listIntelligenceSources, getIntelligenceSource |
| Espresso filter vocabularies | Espresso | GET /espresso/tags, /entities, /regions, /event-types | listIntelligenceTags, listIntelligenceEntities, listIntelligenceRegions, listIntelligenceEventTypes |
Shared pagination, errors, and Bearer rules: API conventions. First authenticated call: First API call.