How to Use the Clash of Clans Strategy & War Analytics MCP in Vercel AI SDK

Q: How do I set up the Clash of Clans Strategy & War Analytics MCP Server with Vercel AI SDK?

Install the @ai-sdk/mcp package and initialize the client using the HTTP transport pointing to your Vinkius endpoint. You then pass the tools from mcpClient.tools() directly into your streamText function to start querying clan data.

Q: Can I stream live CWL status using Clash of Clans Strategy & War Analytics in Vercel AI SDK?

Yes, you can call getcwlgroup to stream the current Clan War League group standings and round matchups directly to your frontend. The streaming setup ensures the data renders incrementally as the API returns the group details.

Q: How do I fetch specific league tiers for my rankings view?

You use listtrophyleagues or listwarleagues to find the correct league IDs first. Once your agent has those IDs, it can filter player profiles or clan searches to match the exact competitive tier you want to display.

Build live-streaming Clash of Clans dashboards using Vercel AI SDK to display war logs and player stats without loading spinners.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Clash of Clans Strategy & War Analytics MCP to Vercel AI SDK

Create your Vinkius account to connect Clash of Clans Strategy & War Analytics to Vercel AI SDK 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 Clash of Clans Strategy & War Analytics with Vercel AI SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Track live clan wars in your Vercel AI SDK UI

Stop making users wait for heavy Clash of Clans data payloads to load. This MCP integration lets you query `get_current_war` and stream the live battle status straight into your Next.js or React components. Your users watch war stars and destruction percentages tick up in real time as the raw JSON transforms into clean UI elements. You can also pull historical performance using `get_clan_war_log` to run quick win-loss ratio calculations on the fly. The streaming client handles the data transfer in the background, meaning your interface stays responsive even during massive 50v50 war events.

Scout rival player profiles instantly

Build a scouting tool that lets clan leaders inspect incoming opponents without leaving the chat interface. By passing player tags directly to `get_player_profile`, your AI client fetches troop levels, hero progress, and war stars instantly. Combine this with `get_clan_members` to parse an entire clan's roster at once. Your Vercel AI SDK application maps these stats directly to your frontend, highlighting rushed bases or high-level threats before the war prep day ends.

Stream global rankings to your custom app

Pull global standings directly into your client's viewport using `get_location_rankings`. Your interface displays the top clans or players in real-time, filtered by specific regions using `list_locations` to locate international trends. This setup lets you build custom leaderboards that update as your agent processes the API responses. It bypasses the need for complex state management on your backend by letting the streaming client handle the heavy lifting.

Setup guide

Set up Clash of Clans Strategy & War Analytics MCP in Vercel AI SDK

Prerequisites

Node.js 18+ and a TypeScript project
ai + @modelcontextprotocol/sdk packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies

Run npm install ai @modelcontextprotocol/sdk plus your preferred model provider (e.g. @ai-sdk/openai).
2

Create the Streamable HTTP transport

Use StreamableHTTPClientTransport with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and use tools

Call mcpClient.tools() to auto-discover all Clash of Clans Strategy & War Analytics tools. Pass them directly to generateText() or streamText() — no manual schema definitions needed.
4

Works with any model provider

Swap openai("gpt-4o") for any AI SDK provider — Anthropic, Google, Mistral. The MCP tools work identically across all supported models.

index.ts

import { experimental_createMCPClient as createMCPClient } from "ai";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp";
import { generateText } from "ai";
import { openai } from "@ai-sdk/openai";

const transport = new StreamableHTTPClientTransport(
  new URL("https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")
);

const mcpClient = await createMCPClient({ transport });
const tools = await mcpClient.tools();

const { text } = await generateText({
  model: openai("gpt-4o"),
  tools,
  prompt: "List recent Clash of Clans Strategy & War Analytics transactions",
});

console.log(text);
await mcpClient.close();

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 Clash of Clans. 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 Clash of Clans Strategy & War Analytics 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 Clash of Clans Strategy & War Analytics MCP in Vercel AI SDK

Install the `@ai-sdk/mcp` package and initialize the client using the HTTP transport pointing to your Vinkius endpoint. You then pass the tools from `mcpClient.tools()` directly into your `streamText` function to start querying clan data.

Yes, you can call `get_cwl_group` to stream the current Clan War League group standings and round matchups directly to your frontend. The streaming setup ensures the data renders incrementally as the API returns the group details.

Yes, this server runs perfectly inside Edge environments when paired with Vercel AI SDK. The lightweight HTTP transport allows your edge routes to fetch player profiles or war logs with minimal latency.

You use `list_trophy_leagues` or `list_war_leagues` to find the correct league IDs first. Once your agent has those IDs, it can filter player profiles or clan searches to match the exact competitive tier you want to display.

Your Clash of Clans developer credentials and clan tags are never stored or exposed to the public. Vinkius runs the MCP Server in an isolated sandboxed environment, executing queries securely and returning only the requested war or player data back to your client.

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