Documentation
Read the platform from your own systems and AI agents: authenticate, fix a lens, reproduce any result and handle every error, over HTTP or the Model Context Protocol.
Start here
Quickstart
Make your first authenticated request, read the situational picture of a lens and pin it to a date and a revision.
Authentication
Access tokens, browser sessions, capabilities, cross-origin rules and the responses to refused requests.
Model Context Protocol
Connect AI agents to the read operations: transport, protocol versions, authentication, tools and results.
Endpoints
Paths on your deployment's API origin, the one your access was issued for.
- /api/v1/intelligence
- Every operation, under one versioned path
- /api/v1/openapi
- The OpenAPI 3.1 document, served without credentials
- /api/v1/mcp
- The read operations as Model Context Protocol tools
- /api/v1/intelligence/health
- The readiness probe, the one public operation
Browse the documentation
Get started
- Quickstart
Make your first authenticated request, read the situational picture of a lens and pin it to a date and a revision.
- Authentication
Access tokens, browser sessions, capabilities, cross-origin rules and the responses to refused requests.
Concepts
- The lens
The as-of date, data revision, window and filters that fix every read, with their formats, defaults and limits.
- Reproducibility
Data revisions, the provenance every response carries, and verifying which methodology release produced a number.
- Sources and provenance
The source catalog, static and live sources, freshness, publication lags, vintages and known gaps.
- Methodology
The published descriptor, releases and their versioning, model versions and the language of likelihood.
API
- Conventions
Versioning and compatibility, requests and responses, representations, caching, pagination and limits.
- Errors
Problem details, every error code with its cause, and how to retry or correct a refused request.
- API reference
Every operation with its parameters, schemas, capability and problems, from the OpenAPI document.
Integrations
- Model Context Protocol
Connect AI agents to the read operations: transport, protocol versions, authentication, tools and results.
- Workbench
Layout, modules, the globe, the time machine, the command bar, keyboard shortcuts and shareable views.
Resources
- Glossary
The terms used across the documentation, defined.
Praxis updates
New sources, methodology releases and changes to the API and the workbench, by email. Confirm your address to subscribe, and unsubscribe from any message.