# Changelog

Track implemented API and documentation changes

> Section: Overview

> Last updated: **2026-10-31**.

> API version: **v1 (Latest)**. OpenAPI publication: **2026-11-08**.

## BeliefState AI integration availability

Published: 2026-10-31. Tags: Docs, MCP.

Find BeliefState across its published AI connections, developer MCP setups and OpenClaw skill.

- BeliefState is published on ChatGPT, shares that OpenAI plugin with Codex, and is available through the Claude and Glama connectors. Cursor and Claude Code have developer MCP setup; OpenClaw has a published ClawHub skill.
- Connection-page search and social metadata, the machine-readable homepage, agent instructions and discovery indexes now identify these connection options. Ask your agent about BeliefState.
- The October 30 OpenAI acceptance verified an eighteen-tool public catalog. Author track record and the newer brief and refresh definitions remain pending; published catalogs do not certify every current direct-MCP tool or open admission for unknown OAuth clients.

## Public Mintlify documentation

Published: 2026-09-26. Tags: Docs.

Public Mintlify documentation replaces the former local HTML documentation pages.

- Mintlify now hosts public HTML documentation, Markdown pages, llms.txt, and a public documentation MCP endpoint at docs.beliefstate.ai.
- The former /docs HTML pages redirect to Mintlify. Existing /docs/*.md, /docs.md, and /docs/mcp endpoints remain available for machine clients while replacement parity is checked.
- Hand written guides require review when API behavior changes. Generated API examples contain schema placeholders, not live investor records.

## A smaller research API

Published: 2026-09-09. Tags: Docs, API, MCP.

One ticker research view, one belief query, one source directory and one coverage query replace overlapping standalone operations.

- The data API now has four resources: /v1/brief, /v1/beliefs, /v1/sources and /v1/tickers. /v1/status remains an access utility. Eleven standalone routes are retired without aliases.
- Use belief_id on /v1/beliefs for full claims, evidence, revisions and outcomes. Use changed_since and person_id for filtered records. Source search, domain and ID selection are filters on /v1/sources.
- MCP and A2A expose get_brief, get_beliefs and get_tickers. Refresh discovery and regenerate clients. The four API documentation entries are direct links without duplicate group headings.

## Automatic documentation social previews

Published: 2026-09-04. Tags: Docs.

Page specific social cards now make shared documentation links identifiable before opening them.

- Every documentation URL now generates its own 1200 by 630 social preview automatically.
- Open Graph and X metadata use the canonical page title, description, and URL instead of the generic site card.
- The page catalog remains the single content source, so new documentation pages inherit previews without manual artwork or configuration.

## Documentation freshness metadata

Published: 2026-09-04. Tags: Docs.

Freshness metadata now tells people and agents when each documentation contract was last updated.

- Every documentation page now shows an exact, content owned last updated date.
- Human pages, per page Markdown, search, and the full LLM corpus read the same freshness metadata.
- Documentation checks reject missing, malformed, future, or stale dates, while scheduled health checks detect source changes newer than the declared date.

## API documentation versioning

Published: 2026-09-04. Tags: Docs, API.

Version context now makes the active API contract explicit without inventing an unsupported documentation snapshot.

- Every documentation page now shows the supported v1 API contract with a Latest status.
- A versioning reference distinguishes the route version, OpenAPI publication, payload schema, and endpoint lifecycle.
- Multi version navigation activates only after a separate historical or new major snapshot exists; no fake history is presented.

## API lifecycle notices

Published: 2026-09-04. Tags: Docs, API.

API lifecycle labels and migration notices now make contract status explicit before integration.

- Release gated API references now carry visible Preview labels on endpoint pages and in navigation.
- Deprecated operations can publish an announcement date, optional removal date, replacement endpoint, and ordered migration steps.
- Human pages and machine readable Markdown now expose the same API lifecycle state without adding visitor tracking.

## Changelog tag filtering

Published: 2026-09-04. Tags: Docs.

Shareable tag filters now make product changes easier to scan by surface.

- Changelog tags now filter human readable updates with multi select AND matching.
- Filter state lives in the URL, supports browser Back, and keeps unrelated query parameters intact.
- Zero result combinations provide a clear recovery while Markdown and RSS remain complete.

## Synchronized code language

Published: 2026-09-04. Tags: Docs, API.

API reference pages now remember one privacy safe request language preference.

- Selecting a request example language now keeps that choice across every API reference page and browser reload.
- Open documentation tabs synchronize the same language preference without account or visitor tracking.
- Invalid or unavailable browser storage fails safely to cURL while the current tab remains usable.

## Reusable documentation snippets

Published: 2026-09-03. Tags: Docs.

Reusable documentation content now keeps human and machine surfaces aligned by construction.

- Eleven static documentation pages now render their sections from one typed reusable snippet registry.
- Human pages, page navigation, per page Markdown, and llms-full.txt now consume the same canonical content.
- The documentation checker rejects missing pages, orphaned snippets, duplicate anchors, invalid section IDs, and malformed shared tables.

## Machine readable documentation

Published: 2026-09-03. Tags: Docs, MCP.

Agents can discover, search, and read the same current documentation humans see.

- Every public documentation page now has a stable .md URL and Accept header content negotiation.
- llms-full.txt now contains the complete documentation corpus, while llms.txt stays a concise directory.
- A public documentation MCP exposes search, read, resources, and bounded feedback.

## Unified capability discovery

Published: 2026-09-03. Tags: API, Agents.

One capability registry now keeps machine interfaces and their discovery metadata aligned.

- REST, MCP, A2A, pricing operations, and documentation references now derive shared intelligence metadata from one capability catalog.
- Well known API, MCP, A2A, and Agent Skills discovery documents now advertise implemented interfaces.
- Four digest verifiable Agent Skills cover setup, security research, provenance audits, and comparable source history.

## Documentation feedback loop

Published: 2026-09-03. Tags: Docs.

Search and feedback now produce a small, privacy bounded documentation improvement loop.

- Documentation search now ranks full page content, recognizes common intent aliases and typos, and shows a matching excerpt.
- Unknown documentation URLs keep a 404 status and offer likely page matches.
- Feedback excludes account and visitor identity. Contextual actions record only the action type and documentation page.
- Every page includes a top of page Use with AI menu for Markdown, ChatGPT, Claude, Perplexity, Cursor, VS Code, and the public docs MCP server.

## Subscribe

Follow the [changelog RSS feed](https://beliefstate.ai/changelog.xml) for machine-readable updates.

## Agent feedback

Report unclear, stale, or incorrect documentation through [BeliefState support](https://beliefstate.ai/contact). Include this page URL and the smallest reproducible detail.

<!-- BeliefState-Origin: https://beliefstate.ai/docs/changelog; Content-Fingerprint: bs-sha256-9fb98edb4128ca0f1a414cd32123b4b67cac670e131bedd0ac85139163067d1d -->
