Baltor Get started

Get set up

Connect Baltor to your harness.

Three steps: create your account, connect your harness, make your first download. Your harness is the program that runs your coding agent, such as Claude Code, Codex or Cursor. Your tools and model access stay yours.

Three ways your agent can reach Baltor

Use one, or all three. None of them needs your model key.

  • MCP server

    Connect your harness

    One server entry in Claude Code, Codex, Cursor, OpenCode, VS Code, Pi or any app that speaks MCP (Model Context Protocol). Your agent searches the library and downloads exact files.

    Checking the connection address

    OAuth sign-in in apps that support it, or a Baltor key from your environment in any app.

    Choose your harness
  • REST API

    Call it from a script

    For CI jobs and your own harness. Send a Baltor key in the Authorization header, search, then download the exact version you chose.

    POST /api/v1/retrieval

    See a search request
    Loading the example request
    Read the search and download guide
  • Feed links

    Give an agent a feed

    No account and no key. Put a source collection's link in your agent's instructions, as JSON Feed or Markdown. Library updates also come as RSS.

    /feeds/collections/coding-benchmarks.md

    Set up feeds for each agent

Step 1

Your account

Check account access

Get started shows the account options this service offers. For help with an existing account, use the support page.

Step 2

Choose your connection

Want a ready-to-run worker?

Download the container with OpenCode and the Baltor harness. Bring your own model access.

Download and set up

Already use a harness?

Pick yours below. Create a Baltor key, keep it in your environment, and copy the connection settings. The configuration contains the variable name, never your key.

Connect an OpenAPI tool server

For apps such as Open WebUI, use the OpenAPI connection to search the same library, inspect an exact version and download its files.

  1. Create a Baltor key on your account page.
  2. In your app's tool-server settings, select OpenAPI and enter https://baltor.ai/api/v1/connect as the server address.
  3. Choose bearer authentication and enter your Baltor key in the app's credential field. Your model key stays with your model provider.
  4. Ask the agent to search for a file, inspect its manifest, and read the exact version it selected. Its read must include a fresh request_id.

Inspect the OpenAPI document. Search and manifests read metadata. The first download of an item version in a calendar month counts once. Files with additional effects still require the step's declared permissions.

Loading the connection settings

Merge this entry into your existing configuration. Do not replace your other settings.

Loading the secret-free configuration.
Open the harness guide

No key included. Set BALTOR_SERVICE_TOKEN to your Baltor key in your environment. These settings contain the variable's name, never your key. Check your setup with Choose a client above.

Compatibility and what this check covers

Loading documented compatibility information.

Cursor, VS Code, Gemini CLI and other MCP apps

These apps reach the same address with a Baltor key. Each entry holds a reference to your key, never the key itself. For Cursor and Gemini CLI, start the app from a terminal where BALTOR_SERVICE_TOKEN is set.

Cursor.cursor/mcp.json

Add this entry to .cursor/mcp.json in your project, or to ~/.cursor/mcp.json for every project.

Loading the connection settings
Open the Cursor guide

Check it in Cursor Settings under MCP, or run agent mcp list with the Cursor CLI.

VS Code.vscode/mcp.json

Add this to .vscode/mcp.json in your workspace. VS Code asks for your Baltor key once and keeps it in its own secret storage.

Loading the connection settings
Open the VS Code guide

Check it with MCP: List Servers in the Command Palette.

Gemini CLI.gemini/settings.json

Add this entry to .gemini/settings.json in your project, or to ~/.gemini/settings.json.

Loading the connection settings
Open the Gemini CLI guide

Check it with gemini mcp list.

Any other app that speaks MCP over Streamable HTTP connects the same way: the address above, your Baltor key in the Authorization header from your environment, and Baltor-Step-Effects to say what its steps may do.

Temporary setup in Bash

This prompt hides the value while you enter it. The value is not part of the command history. The client process inherits the environment variable.

read -rsp "Baltor key: " BALTOR_SERVICE_TOKEN
export BALTOR_SERVICE_TOKEN

After closing the client, clear the terminal variable with unset BALTOR_SERVICE_TOKEN. Do not run environment dumps or record the terminal while handling secrets.