Have an AI agent? Let it explore Baltor for you. Any assistant works, personal or coding.

Connect your agent
What your agent reads

The request it copies

Explore baltor.ai for me and report back. Start with https://baltor.ai/llms.txt, then read https://baltor.ai/.well-known/agent-card.json and https://baltor.ai/.well-known/mcp.json. Tell me which plan (Feeds at $4.99/mo, Pro at $29/mo, or Max at $49/mo) fits my work, what you would connect, and the setup steps at https://baltor.ai/connect. Stay read-only: read public pages and agent files, and check with me before any sign-in, purchase or change. If a step needs a key, name it (BALTOR_SERVICE_TOKEN) and I will add it myself.

Discovery files on baltor.ai

Read-only discovery is open. Keep BALTOR_SERVICE_TOKEN in your own environment.

Baltor
Sign in Get started

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.

MethodPathWhat it does
GET/api/v1/capabilitiesProtocol, limits and features
GET/api/v1/healthHealth and readiness
GET/llms.txtWhat the service offers, written for AI agents
GET/.well-known/oauth-authorization-serverOAuth discovery
GET/sitemap.xmlThe 52 indexed pages
Health, read October 25, 2026Live reading
curl https://baltor.ai/api/v1/health
# An excerpt of the result
{
"alive": true,
"ready": true,
"service_version": "0.1.0",
"catalogue_served_files": 1560856
}

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.

MethodPathWhat it does
GET/api/v1/sessionThe account and scopes behind a key
POST/api/v1/retrievalSearch. Results come back here; bodies arrive with a download.
POST/api/v1/provisioningDiscover, list or read an item's manifest, or read a small item inline
POST/api/v1/downloadThe exact bytes of an item or one of its files
GET/api/v1/usageThis account's recorded downloads
A keyed request
# The key comes from your environment
curl https://baltor.ai/api/v1/session \
-H "Authorization: Bearer $BALTOR_SERVICE_TOKEN"

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-25 for the handshake, 2026-07-28 per 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
ToolWhat it does
intelligence_searchSearches the library
provisioning_manifestLists an item's files
provisioning_readReads the exact files
public_good_filesReturns 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.

PathOperation
/api/v1/connect/searchintelligence_search
/api/v1/connect/manifestprovisioning_manifest
/api/v1/connect/readprovisioning_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.

MethodPathWhat it does
GET/feeds/sources.mdEvery source collection, as Markdown
GET/feeds/sources.jsonEvery source collection, as JSON Feed
GET/feeds/collections/{id}.mdOne collection, as Markdown or .json
GET/feeds/catalogue.jsonLibrary updates, also as .rss and .md

The 19 collection ids

coding-benchmarksretrieval-benchmarksmodel-costsafety-benchmarkshardware-fitmodel-switchmodel-releasesmcp-servicesresearch-papersfounder-stackdeveloper-releasesagent-framework-releasescoding-agent-releasessecurity-advisoriescreative-enginescreative-mcp-serversproduct-discoveryhackathonsfinance-research

Scopes and limits

From the capabilities record, read October 25, 2026.

ScopeAllows
provisioning:metadataMetadata and search
provisioning:readBodies and downloads
usage:readUsage
billing:manageBilling 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.

reads_fswrites_fsreads_secretnetworkspawns_process
LimitValue
Request65,536 bytes
Response16,777,216 bytes
Search results50 per search
Inline body16,384 bytes
Download1,048,576 bytes
Operations at once8, with 4 for each account
Failed sign-in attempts30 a minute for each address, then failed_attempt_limit_reached
OAuth server240 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.