Skip to main content
Set up your integration with Cursor, Claude Code, Antigravity, or Claude and manage your agent configurations using natural language.
The Tuner MCP Server is currently in Beta. Available actions and supported platforms may expand over time.
Tuner MCP Server: https://api.usetuner.ai/mcp/

​
IDEs

Connect Tuner to your IDE to manage agent configurations directly from your development environment. The MCP server uses API-key authentication through an Authorization header. Get your API key from Tuner and use it as a Bearer token when configuring the MCP in your IDE.

​
Cursor

1

Open MCP Settings

Go to Settings → Tools & MCP and click Add Custom MCP to open your mcp.json.
2

Paste the Configuration

Add the following to your mcp.json:
{
  "mcpServers": {
    "tuner": {
      "type": "streamableHttp",
      "url": "https://api.usetuner.ai/mcp/",
      "headers": {
        "Authorization": "Bearer YOUR_TUNER_API_KEY"
      }
    }
  }
}
Replace YOUR_TUNER_API_KEY with your Tuner API key.

​
Claude Code

1

Run the Add Command

Open your terminal inside Claude Code and run:
claude mcp add tuner https://api.usetuner.ai/mcp/ --transport http --header "Authorization: Bearer YOUR_TUNER_API_KEY"
Replace YOUR_TUNER_API_KEY with your Tuner API key.

​
Antigravity

1

Open MCP Configuration

Click the … dropdown at the top of the editor’s agent panel, then Manage MCP Servers → View raw config to open mcp_config.json.
2

Paste the Configuration

Add the following to your mcp_config.json:
{
  "mcpServers": {
    "tuner": {
      "serverUrl": "https://api.usetuner.ai/mcp/",
      "headers": {
        "Authorization": "Bearer YOUR_TUNER_API_KEY",
        "Content-Type": "application/json"
      }
    }
  }
}
Replace YOUR_TUNER_API_KEY with your Tuner API key.

​
Chatbots

Connect Tuner to your AI chatbot to manage agent configurations through natural language conversations. Chatbots connect to Tuner using OAuth-based authentication. When you add the Tuner MCP server for the first time, you will be redirected to Tuner’s sign-in page to authorize access. Once authenticated, your session remains active and you won’t need to re-authenticate unless you revoke access.

​
Claude

1

Add Custom Connector

You need a Pro subscription or higher. Go to Settings → Connectors, click Add Custom Connector, and paste your Tuner MCP Server URL:
https://api.usetuner.ai/mcp/
2

Connect and Authenticate

Click Connect. You will be redirected to Tuner to sign in and authorize access.
3

Enable Tuner in Your Chat

When starting a new chat, click the + button and verify Tuner is toggled on under Connectors.

​
Start the Setup

Once you’ve connected Tuner to your chatbot or IDE, paste the following into your chat to begin configuring your agent: 
Set up Tuner observability for this agent using the Tuner MCP.
Fetch and follow the 'tuner_setup_agent' prompt from the Tuner MCP server.
Replace agent_id, workspace_id, agent_name, and direction with your own agent’s details from the Tuner dashboard.

​
Troubleshooting

  • Chatbots: Verify you’re using the correct MCP Server URL from the Tuner Dashboard. Ensure your Tuner account is active and you have the required subscription.
  • IDEs: Check that your API key is valid and correctly placed in the configuration file. Make sure https://api.usetuner.ai/mcp/ is reachable.
  • Chatbots: Try disconnecting and reconnecting. In Claude, go to Settings → Connectors and remove Tuner, then add it again. In ChatGPT, remove the app and re-create it.
  • IDEs: Regenerate your API key from the Tuner Dashboard and update your configuration file.
  • ChatGPT: Ensure Developer Mode is enabled. Open a new chat, click +, go to More, and select Tuner.
  • Claude: Click the + button and check that Tuner is toggled on under Connectors.
  • IDEs: Verify the MCP server configuration is saved correctly and restart the IDE if needed.

​
What’s Next?

Manage Tuner with MCP

Examples, best practices, and use cases for managing your agent with AI assistants.

Classifying Calls

Learn about call outcomes and user intents you can configure via MCP.

Creating Custom Evaluations

Understand behavior checks that you can create through your AI assistant.

Custom Integration

Send call data to Tuner via the REST API.