How to Use the Agora MCP in Claude Code

Q: How can I use the Agora server with Claude Code in a shell script?

You call the tools directly from your script. For example, PROJECTID=$(claude agora-mcp createproject ...) saves a new project's ID to a variable. The output is clean text, so you can easily pipe it to other CLI tools like grep or jq.

Q: What's the best way to monitor Agora project usage with Claude Code?

Write a script that calls listprojects, then loops through each project ID to call getusagestats. You can run this script as a cron job and pipe the output to a monitoring service or a log file.

Q: How do I add this MCP server to Claude Code?

It's one command in your terminal: claude mcp add --transport http agora-mcp -- . You can check that it's connected by running claude mcp list.

Manage Agora projects and recordings directly from the terminal. Perfect for scripts, cron jobs, and CI/CD pipelines with Claude Code.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Agora MCP to Claude Code

Create your Vinkius account to connect Agora 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 Agora with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Script Your Entire Agora Workflow

Since Claude Code is just a CLI, you can pipe its output anywhere. Run `claude agora-mcp list_active_calls | jq` to parse live call data in a shell script. It's built for automation. Create a simple bash script to report on daily usage. Have it call `claude agora-mcp list_projects` and loop through the results, calling `get_usage_stats` for each. This is how you automate monitoring from the command line.

Run Agora Operations in CI/CD

Set up a new project as part of your deployment process. In your GitHub Actions or Jenkins file, just add a step: `claude agora-mcp create_project --name 'New Feature Branch Build'`. The project is ready before your tests even run. This MCP Server also lets you manage test recordings. Add a step to `start_cloud_recording` at the beginning of a test run and `stop_cloud_recording` at the end. The output can be logged directly to your CI console.

Your Headless Agora Admin

This isn't for fancy UIs. It's for getting things done. SSH into a server and check on a project with `claude agora-mcp get_project_details --id <project_id>`. You get a clean, scriptable response. Set up a cron job to check for stalled recordings every hour. The job would simply run `claude agora-mcp query_cloud_recording` on active sessions and alert you if something is wrong. This is what a headless agent is for.

Setup guide

Set up Agora 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 agora-mcp with a green status indicator.
3

Start using tools

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

Terminal

claude mcp add --transport http agora-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 Agora 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": {
    "agora-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 Agora. 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 Agora 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 Agora MCP in Claude Code

You call the tools directly from your script. For example, `PROJECT_ID=$(claude agora-mcp create_project ...)` saves a new project's ID to a variable. The output is clean text, so you can easily pipe it to other CLI tools like `grep` or `jq`.

Yes, that's a primary use case. Add a command to your pipeline script to `start_cloud_recording` before tests run and `stop_cloud_recording` after. It integrates directly into any command-line environment.

Write a script that calls `list_projects`, then loops through each project ID to call `get_usage_stats`. You can run this script as a cron job and pipe the output to a monitoring service or a log file.

It's one command in your terminal: `claude mcp add --transport http agora-mcp -- `. You can check that it's connected by running `claude mcp list`.

Only the data needed for the command you run. This includes project names, IDs, usage metrics, and call metadata. Each command runs in a zero-trust, ephemeral sandbox on Vinkius, and your credentials are never exposed.

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