CLSTR · OpenAPI Overlay 1.0.0
CLSTR API enhancements (API Evangelist)
17 actions
17 updates
update
extends
../openapi/_ae-authored/clstr-news-openapi-generated.yml
Derived by API Evangelist
Built from the contracts CLSTR publishes. CLSTR did not publish this file.
What the actions change
x-mcp-toolx-mcp-serverx-llms-txt
Targets 9
$.paths['/v1/situations'].get.parameters
$.paths['/v1/situations/{situationidorslug}'].get.parameters
$.paths['/v1/clusters/{clusteridorslug}'].get.parameters
$.paths['/v1/search'].get.parameters
$.paths['/v1/situations'].get
$.paths['/v1/search'].get
$.paths['/v1/situations/{situationidorslug}'].get
$.paths['/v1/clusters/{clusteridorslug}'].get
$.info
OpenAPI Overlay
overlay: 1.0.0
info:
title: CLSTR API enhancements (API Evangelist)
version: 1.0.0
extends: ../openapi/_ae-authored/clstr-news-openapi-generated.yml
x-provenance:
generated: '2026-11-04'
method: derived
source:
- https://clstr.news/developers.md
actions:
- target: $.paths['/v1/situations'].get.parameters
description: Add documented days parameter (clstr.news/developers.md)
update:
- name: days
in: query
required: false
description: 1 to your tier's history window (7 on Free). Larger values are clamped; X-Window-Days reports the window
served.
schema:
type: integer
default: 7
minimum: 1
- target: $.paths['/v1/situations'].get.parameters
description: Add documented sort parameter (clstr.news/developers.md)
update:
- name: sort
in: query
required: false
description: relevance or recent.
schema:
type: string
enum:
- relevance
- recent
default: relevance
- target: $.paths['/v1/situations'].get.parameters
description: Add documented category parameter (clstr.news/developers.md)
update:
- name: category
in: query
required: false
description: One category slug, e.g. international.
schema:
type: string
- target: $.paths['/v1/situations'].get.parameters
description: Add documented country parameter (clstr.news/developers.md)
update:
- name: country
in: query
required: false
description: Comma separated ISO country codes, up to 10. Extras are dropped, not rejected.
schema:
type: string
- target: $.paths['/v1/situations'].get.parameters
description: Add documented summary parameter (clstr.news/developers.md)
update:
- name: summary
in: query
required: false
description: preview or full. full requires Builder or Scale; X-Summary-Mode reports the mode served.
schema:
type: string
enum:
- preview
- full
default: preview
- target: $.paths['/v1/situations'].get.parameters
description: Add documented cursor parameter (clstr.news/developers.md)
update:
- name: cursor
in: query
required: false
description: From the previous response's next_cursor. Paging stops after 81 pages.
schema:
type: string
- target: $.paths['/v1/situations/{situationidorslug}'].get.parameters
description: Add documented timeline_limit parameter (clstr.news/developers.md)
update:
- name: timeline_limit
in: query
required: false
description: 1 to 500.
schema:
type: integer
default: 100
minimum: 1
maximum: 500
- target: $.paths['/v1/situations/{situationidorslug}'].get.parameters
description: Add documented timeline_before parameter (clstr.news/developers.md)
update:
- name: timeline_before
in: query
required: false
description: Cluster id cursor. Returns a continuation page.
schema:
type: string
- target: $.paths['/v1/clusters/{clusteridorslug}'].get.parameters
description: Add documented articles parameter (clstr.news/developers.md)
update:
- name: articles
in: query
required: false
description: 1 to 100 source articles. Larger values are clamped.
schema:
type: integer
default: 100
minimum: 1
maximum: 100
- target: $.paths['/v1/search'].get.parameters
description: Add documented limit parameter (clstr.news/developers.md)
update:
- name: limit
in: query
required: false
description: 1 to 30.
schema:
type: integer
default: 30
minimum: 1
maximum: 30
- target: $.paths['/v1/search'].get.parameters
description: Add documented cursor parameter (clstr.news/developers.md)
update:
- name: cursor
in: query
required: false
description: From the previous response's next_cursor (its own token, not the situations cursor).
schema:
type: string
- target: $.paths['/v1/search'].get.parameters
description: Add documented summary parameter (clstr.news/developers.md)
update:
- name: summary
in: query
required: false
description: Accepted; every search result already carries its summary in full, so it changes nothing.
schema:
type: string
enum:
- preview
- full
- target: $.paths['/v1/situations'].get
description: Bind MCP tool get_top_situations
update:
x-mcp-tool:
name: get_top_situations
server: https://mcp.clstr.news/mcp
readOnlyHint: true
- target: $.paths['/v1/search'].get
description: Bind MCP tool search_situations
update:
x-mcp-tool:
name: search_situations
server: https://mcp.clstr.news/mcp
readOnlyHint: true
- target: $.paths['/v1/situations/{situationidorslug}'].get
description: Bind MCP tool get_situation_timeline
update:
x-mcp-tool:
name: get_situation_timeline
server: https://mcp.clstr.news/mcp
readOnlyHint: true
- target: $.paths['/v1/clusters/{clusteridorslug}'].get
description: Bind MCP tool get_cluster
update:
x-mcp-tool:
name: get_cluster
server: https://mcp.clstr.news/mcp
readOnlyHint: true
- target: $.info
description: Agent-surface pointers
update:
x-mcp-server: https://mcp.clstr.news/mcp
x-llms-txt: https://clstr.news/llms.txt
Work with this as data
Every overlay here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for openapi overlays
4 MCP tools reach this
find_overlaysBrowse and filter every overlay in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This overlay
curl "https://apis.io/api/v1/overlays/clstr-news-api-overlay"
All openapi overlays
curl "https://apis.io/api/v1/overlays?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.