Every Baltor endpoint, public and keyed
One host serves the MCP endpoint, a versioned JSON API and public feeds. Capabilities and health are open to everyone; the library routes take a Baltor key.
- Read from llms.txt and the capabilities record, October 25, 2026
- Host
https://baltor.ai
Open to everyone
Anyone can read these. Your client can check the service before it asks for access.
| Method | Path | What it does |
|---|---|---|
| GET | /api/v1/capabilities | Protocol, limits and features |
| GET | /api/v1/health | Health and readiness |
| GET | /llms.txt | What the service offers, written for AI agents |
| GET | /.well-known/oauth-authorization-server | OAuth discovery |
| GET | /sitemap.xml | The 52 indexed pages |
With a Baltor key
Send your key as a bearer header. Keep it in your environment as BALTOR_SERVICE_TOKEN; your settings hold the variable name.
| Method | Path | What it does |
|---|---|---|
| GET | /api/v1/session | The account and scopes behind a key |
| POST | /api/v1/retrieval | Search. Results come back here; bodies arrive with a download. |
| POST | /api/v1/provisioning | Discover, list or read an item's manifest, or read a small item inline |
| POST | /api/v1/download | The exact bytes of an item or one of its files |
| GET | /api/v1/usage | This account's recorded downloads |
The MCP endpoint
Harnesses and MCP apps connect here. Claude Code, Codex, OpenCode and Pi each take one entry.
- Address
https://baltor.ai/mcp- Transport
- Streamable HTTP
- Versions
2025-11-25for the handshake,2026-07-28per request- Session
- Stateless: each request carries its own key
- Sign-in
- OAuth with PKCE (S256), a consent page and refresh, where your app supports it. Or a Baltor key in the Authorization header.
- SDK
- Version 2.2.0
| Tool | What it does |
|---|---|
intelligence_search | Searches the library |
provisioning_manifest | Lists an item's files |
provisioning_read | Reads the exact files |
public_good_files | Returns free Public Good files for signed-in accounts |
The OpenAPI tool server
Apps that take OpenAPI tools use the same three operations, described at /api/v1/connect/openapi.json (OpenAPI 3.1.0, document version 1.0.0). Any origin may call it with a bearer key.
Request headers it accepts: Authorization, Content-Type, X-Session-Id, Baltor-Step-Effects.
| Path | Operation |
|---|---|
/api/v1/connect/search | intelligence_search |
/api/v1/connect/manifest | provisioning_manifest |
/api/v1/connect/read | provisioning_read |
Agent Feeds, open to read
Public: the address is all you send, and feed addresses take the path alone. Send the last ETag in If-None-Match, and an unchanged feed answers 304.
| Method | Path | What it does |
|---|---|---|
| GET | /feeds/sources.md | Every source collection, as Markdown |
| GET | /feeds/sources.json | Every source collection, as JSON Feed |
| GET | /feeds/collections/{id}.md | One collection, as Markdown or .json |
| GET | /feeds/catalogue.json | Library updates, also as .rss and .md |
The 19 collection ids
Scopes and limits
From the capabilities record, read October 25, 2026.
| Scope | Allows |
|---|---|
provisioning:metadata | Metadata and search |
provisioning:read | Bodies and downloads |
usage:read | Usage |
billing:manage | Billing sessions |
Step effects
The Baltor-Step-Effects header names what a step may do. reads_fs is the default. An item that needs more shows the effects to declare, and its read answers step_effects_required.
| Limit | Value |
|---|---|
| Request | 65,536 bytes |
| Response | 16,777,216 bytes |
| Search results | 50 per search |
| Inline body | 16,384 bytes |
| Download | 1,048,576 bytes |
| Operations at once | 8, with 4 for each account |
| Failed sign-in attempts | 30 a minute for each address, then failed_attempt_limit_reached |
| OAuth server | 240 requests, 120 token requests and 10 registrations a minute for each process |
Connect an agent in one entry.
Pro is $29 a month for the whole library, with a key for each client you connect.
Looking for model hosts?
Each model page lists its providers and prices, and Can I run it sizes models for your hardware.