How to Use the Gameball MCP in Claude Code

Q: How do I register the Gameball Alternative MCP Server in Claude Code?

Use the MCP CLI command to add the server: claude mcp add --transport http gameball-alternative -- . Make sure all flags come before the server name. You can verify the installation by running claude mcp list.

Q: How does the Gameball Alternative MCP Server handle high-volume event tracking in Claude Code?

The sendevents tool is designed for lightweight, high-volume tracking. Claude Code can pipe batch transaction logs directly into the tool, processing thousands of customer events without hitting rate limits.

Q: How do I inspect specific orders using this server?

Run getordertransactions through Claude Code. It prints a clean JSON array of all loyalty events associated with that order ID, letting you verify point allocations immediately.

Run headless loyalty automations and manage customer points 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 Gameball MCP to Claude Code

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Run Loyalty Program Tools via the MCP Server

The `get_customer_balance` tool retrieves a user's current point totals directly inside your terminal session. Claude Code runs this tool to check balances during debugging or to pipe the output into other CLI utilities. You can combine this with `get_customer_activities` to see a complete history of points earned and spent. This makes terminal-based troubleshooting of customer accounts fast and scriptable.

Bulk Customer Profile Syncing

The `create_or_update_customer` tool updates customer details in bulk without risk of duplication. Claude Code can process a CSV file of user data and loop through this tool to sync your database with your loyalty platform. Because the tool is idempotent, network interruptions won't corrupt your data. Claude Code handles the retries and logs the final state directly to your terminal.

Automate Point Refunds via CLI

The `refund_transaction` tool reverses point allocations for returned items. Claude Code executes this tool in headless environments, allowing you to trigger loyalty refunds from cron jobs or backend scripts. To verify the refund, your agent can run `get_order_transactions` to check the status of the ledger. This keeps your loyalty balances accurate without requiring a browser or GUI.

Setup guide

Set up Gameball 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 gameball-alternative-mcp with a green status indicator.
3

Start using tools

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

Terminal

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

Use the MCP CLI command to add the server: `claude mcp add --transport http gameball-alternative -- `. Make sure all flags come before the server name. You can verify the installation by running `claude mcp list`.

Yes. You can command Claude Code to write shell scripts that run `send_events` for specific customer actions, allowing you to run automated cron jobs that update loyalty statuses overnight.

The `send_events` tool is designed for lightweight, high-volume tracking. Claude Code can pipe batch transaction logs directly into the tool, processing thousands of customer events without hitting rate limits.

Run `get_order_transactions` through Claude Code. It prints a clean JSON array of all loyalty events associated with that order ID, letting you verify point allocations immediately.

Yes. The server processes customer accounts, transaction histories, and point balances through an ephemeral, zero-trust Vinkius container. Your API credentials are never exposed to the terminal output.

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