Beans News API & MCP
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. Cafecito uses a changing catalog of public-information and publicly available sources/outlets. Coverage, availability, and update timing vary and do not imply source endorsement, complete coverage, or unrestricted content rights. All Cafecito products are currently available as free tier. When paid services are introduced, applicable pricing, billing, renewal, cancellation, refund, tax, and additional contract terms will be presented before purchase. Collections return {data, pagination, meta} with pagination.limit, pagination.num_results (this page only), pagination.next_cursor, and meta.as_of. Empty collections return HTTP 200 with data: []. Missing detail resources return HTTP 404. Application errors (400, 404, 500) return { "error": { "code", "message" } }. Gateway authentication and rate-limit failures return HTTP 401 and 429 as RFC 7807 Problem Details. Unknown or route-inapplicable query parameters return HTTP 400. content_type=post is not a valid request filter and returns HTTP 400; post may still appear on Article responses. REST and MCP operations require Authorization: Bearer <api-key> except /beans/health.

