How to Use the Baseten MCP in Claude Code

Q: Does Claude Code expose my Baseten workspace secrets?

No. The listsecrets tool only displays secret names to verify their existence. Your actual secret values remain secure and are never printed to the stdout.

Manage Baseten serverless models and run predictions directly from the Claude Code command line interface.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Baseten MCP to Claude Code

Create your Vinkius account to connect Baseten to Claude Code and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Baseten with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Run Baseten predictions from the command line

Claude Code uses the `predict` tool to trigger serverless model inferences directly within your terminal session. It formats input dictionaries and sends them to your active Baseten endpoint. This lets you pipe prediction outputs to other CLI tools, automate inference testing in your shell scripts, or quickly verify model outputs without opening a browser or writing custom Python scripts.

Inspect deployments using this MCP Server

This MCP Server gives Claude Code direct access to your model metadata. The agent runs `list_models` and `get_model` to verify which model versions are currently running in your workspace. If you need to debug a slow endpoint, the agent uses `list_deployments` to inspect active inference instances. This lets you monitor your production infrastructure directly from your terminal workflow.

Check workspace secrets safely in Claude Code

Claude Code can verify your API setup before triggering predictions. It runs `list_secrets` to view active workspace secret names without exposing the raw values in your terminal scrollback. It then uses `get_deployment` to confirm your configuration matches the active deployment target. This keeps your terminal-based workflows secure while ensuring your pipeline runs smoothly.

Setup guide

Set up Baseten MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see baseten-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest Baseten transactions." It will automatically discover and invoke the available Baseten tools.

Terminal

claude mcp add --transport http baseten-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the Baseten MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "baseten-mcp": {
      "type": "url",
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Baseten. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Baseten now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Baseten MCP in Claude Code

Run the claude mcp add command with the transport flag and your Vinkius server URL. The CLI client will automatically register the model management tools.

Yes. Because Claude Code runs headless, you can use the predict tool in your automation scripts to run inferences during your continuous integration pipelines.

No. The list_secrets tool only displays secret names to verify their existence. Your actual secret values remain secure and are never printed to the stdout.

It uses the SSE or HTTP transport layer managed by Vinkius. This allows your terminal client to communicate securely with your model endpoints.

Your model inputs are processed inside an isolated V8 sandbox on Vinkius. The platform handles authorization securely, ensuring your raw payload data is never logged or stored.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript