Skip to main content
This page installs the skill and MCP servers so an agent can operate your Baseten workspace and search these docs. To point Claude Code, Codex CLI, Pi, Droid, or OpenCode at Model APIs, see Coding agents. Install the Baseten skill and two MCP servers. The skill teaches the agent how to use them.
  • baseten (https://api.baseten.co/mcp) operates your Baseten workspace. The agent can list and manage models, deployments, environments, training jobs, secrets, and chains. This server requires a management API key.
  • baseten_docs (https://docs.baseten.co/mcp) searches these docs for up to date information.
You need Node 18+.

Install

To install the skill and MCP servers:
  1. Create a dedicated key with management permissions in your API key settings. A dedicated key lets you revoke agent access without affecting inference or other tools.
  2. Set it in your shell so the installer can read it:
    To persist the key, add the line to your shell profile (~/.zshrc or ~/.bashrc). On Windows, run setx BASETEN_MCP_KEY "...".
  3. Run these commands in a shell that exports BASETEN_MCP_KEY. -g installs for every detected tool. -y skips prompts:
  4. Restart your agent.
To have your agent run the install instead, paste this prompt into it. Don’t print the key:
To confirm the servers connected:Run /mcp. You should see:
If Claude Code prompts before reading skill files, add this to ~/.claude/settings.json:
Ask the agent to list the models in your workspace, or invoke the skill with /baseten. Each MCP instance is scoped to one workspace by its API key. To work with multiple workspaces, install additional instances under different names with different keys.

Configure a specific agent

Use this when auto-detect doesn’t cover your tool. Add the MCP servers to its config and install the skill with npx skills add basetenlabs/baseten-skills. baseten_docs needs no auth, so omit its header for a docs-only setup.
To add the MCP servers by hand:Add this to mcp.json:
mcp.json
npx add-mcp and npx skills add also detect Codex, Antigravity, Goose, Windsurf, and other supported agents. For GUI clients like Claude Desktop, add the server URL under their connector settings. Any MCP-compatible tool works with the URLs above.

Next steps

Coding agents

Call Model APIs from Pi, Droid, or OpenCode, or install Baseten Switch for Claude Code, Codex CLI, or Pi.

Deploy your first model

Package a model with Truss and deploy it on dedicated GPUs.
Append .md to any docs URL for clean Markdown, or use llms.txt (page index) and llms-full.txt. The Copy page button at the top-right of any page copies it as Markdown or opens it as plain text:
The page context menu with options to copy or open documentation as Markdown.
These docs also auto-host a lightweight single-file skill at docs.baseten.co/skill.md (npx skills add https://docs.baseten.co). Use it only where you can’t install the baseten skill from the repo.