How to Use the NinjaCat MCP in Claude Code

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

Run the command claude mcp add --transport http ninjacat -- in your terminal. This registers the server, allowing Claude Code to access your marketing reports immediately.

Q: Can I use Claude Code to export NinjaCat data to bash scripts?

Yes. Claude Code can run getreportdownloadurl and output the URL directly to your terminal, allowing you to curl the report file straight into your scripts.

Q: How does Claude Code handle NinjaCat rate limits?

The CLI manages tool execution sequentially. When calling listdataaccounts or listagencycampaigns, it processes requests one by one to avoid hitting API thresholds.

Q: How secure is my NinjaCat campaign metadata in Claude Code?

Your API keys are stored locally in your /.claude.json config. Vinkius routes the MCP calls through a zero-trust sandbox, meaning your campaign metadata and advertiser profiles are never cached or logged.

Pipe NinjaCat marketing reports and advertiser data directly into your terminal using 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 NinjaCat MCP to Claude Code

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Pipe marketing reports to terminal tools

Claude Code brings your marketing reports straight to the command line. You can tell the CLI to fetch your latest data, and it uses `get_report_download_url` to grab the file and pipe it to standard terminal utilities. It uses `list_reports` and `get_report_history` to verify which files are fresh. You can filter, grep, and process your NinjaCat reports without ever opening a browser.

Script advertiser audits via this MCP Server

This MCP Server lets you run lightweight automation scripts directly from your shell. Claude Code calls `list_advertisers` to pull your client roster, then uses `get_advertiser` to verify specific account configurations. You can combine this with local shell commands to audit your clients. The agent pulls the data, matches it against your local environments, and outputs clean JSON to your terminal.

Monitor agency campaigns from the CLI

Track your marketing performance without heavy desktop apps. Claude Code uses `list_agency_campaigns` to list active campaigns, and `list_data_sources` to check which platforms are currently feeding data. It verifies agency metadata with `get_agency_info` and checks your active session with `get_me`. You get a fast, text-based status report of your entire marketing stack in one command.

Setup guide

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

Start using tools

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

Terminal

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

Run the command `claude mcp add --transport http ninjacat -- ` in your terminal. This registers the server, allowing Claude Code to access your marketing reports immediately.

Yes. Claude Code can run `get_report_download_url` and output the URL directly to your terminal, allowing you to curl the report file straight into your scripts.

The CLI manages tool execution sequentially. When calling `list_data_accounts` or `list_agency_campaigns`, it processes requests one by one to avoid hitting API thresholds.

Absolutely. Because Claude Code is terminal-based, you can run it in automated environments to fetch advertiser data using `list_advertisers` as part of your deployment pipelines.

Your API keys are stored locally in your ~/.claude.json config. Vinkius routes the MCP calls through a zero-trust sandbox, meaning your campaign metadata and advertiser profiles are never cached or logged.

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