How to Use the Octoboard MCP in Claude Code

Q: How do I add the Octoboard MCP Server to Claude Code?

Run the command claude mcp add --transport http octoboard -- in your terminal. You can verify that the server is successfully connected by running claude mcp list.

Q: How do I verify my credentials using Claude Code and Octoboard?

You can execute testoctoboardauth through the terminal interface to check your API key. The tool returns a direct confirmation of your credential status.

Q: Can I automate client reports with Claude Code?

Yes, you can combine listagencyclients with shell commands to loop through your accounts. This lets you push custom metrics to specific client dashboards using cron jobs or terminal scripts.

Pipe marketing data and trigger automated Octoboard dashboard updates directly from your terminal using Claude Code.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect Octoboard MCP to Claude Code

Create your Vinkius account to connect Octoboard to Claude Code — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup Octoboard with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Terminal-driven dashboard updates.

The `push_numeric_metric` tool updates numerical widgets on your marketing dashboards directly from a CLI shell. You can pipe script outputs straight to this tool to update KPIs without opening a browser. This is built for terminal workflows running over the MCP standard. Feeding local performance metrics into `push_variation_metric` lets you instantly update progress percentages on client dashboards during deployment.

Scripted client reporting via MCP Server.

The `list_automated_reports` tool lets you check scheduled reports from any SSH session or terminal environment. You can quickly see which marketing reports are pending and run updates without leaving your command-line interface. Using this tool inside a shell script allows you to query report statuses. Piping the JSON output to other Unix utilities lets you build custom server-side automation.

Terminal connection monitoring.

The `get_api_status` tool verifies your connection to the marketing API directly from the command line. It returns immediate connection details so you can debug network issues before running large batch updates. If a push fails, you can run `check_api_usage` to see if you have hit your data limits. This keeps your automated cron jobs running smoothly without silent failures.

Setup guide

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

Start using tools

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

Terminal

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

Run the command `claude mcp add --transport http octoboard -- ` in your terminal. You can verify that the server is successfully connected by running `claude mcp list`.

Yes, you can pipe local data arrays directly into tools like `push_bar_chart` and `push_data_table`. Claude Code processes the input in your terminal and executes the updates sequentially.

You can execute `test_octoboard_auth` through the terminal interface to check your API key. The tool returns a direct confirmation of your credential status.

Yes, you can combine `list_agency_clients` with shell commands to loop through your accounts. This lets you push custom metrics to specific client dashboards using cron jobs or terminal scripts.

Vinkius routes all tool executions through a secure, ephemeral V8 sandbox. Your API keys and client reporting data are processed in-memory and never written to persistent storage, keeping your credentials safe.

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