Do I need an API key?

No! CoinCap's API is completely free and requires no authentication. Just subscribe and start querying. Rate limit is 30 requests/second on the free tier.

What cryptocurrencies are supported?

CoinCap tracks thousands of cryptocurrencies including Bitcoin, Ethereum, Solana, XRP, Cardano, Dogecoin, Avalanche, Polkadot and many more. Use list_assets with the search parameter to find any coin by name or symbol.

Can I get OHLCV data for technical analysis?

Yes! Use get_candles with the asset ID and interval (m1, m5, m15, m30, h1, h2, h6, h12, d1). Returns open, high, low, close and volume for each candle period.

Can I see which exchanges list a specific crypto?

Yes! Use get_markets with asset_id to see all exchanges that list a specific cryptocurrency. Results include the exchange name, trading pair, current price, 24h volume and volume percentage.

CoinCap MCP Server for Mastra AI 9 tools — connect in under 2 minutes

Name: CoinCap
Availability: InStock
Author: Vinkius

docs.mastra.ai/docs/agents/mcp-tools

Built by Vinkius GDPR 9 Tools SDK

Mastra AI is a TypeScript-native agent framework built for modern web stacks. Connect CoinCap through Vinkius and Mastra agents discover all tools automatically. type-safe, streaming-ready, and deployable anywhere Node.js runs.

Get MCP Server for AI Agents

ASK AI ABOUT THIS MCP SERVER

Open in ChatGPT Open in Claude Open in Perplexity

Vinkius supports streamable HTTP and SSE.

typescript

import { Agent } from "@mastra/core/agent";
import { createMCPClient } from "@mastra/mcp";
import { openai } from "@ai-sdk/openai";

async function main() {
  // Your Vinkius token. get it at cloud.vinkius.com
  const mcpClient = await createMCPClient({
    servers: {
      "coincap": {
        url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
      },
    },
  });

  const tools = await mcpClient.getTools();
  const agent = new Agent({
    name: "CoinCap Agent",
    instructions:
      "You help users interact with CoinCap " +
      "using 9 tools.",
    model: openai("gpt-4o"),
    tools,
  });

  const result = await agent.generate(
    "What can I do with CoinCap?"
  );
  console.log(result.text);
}

main();

Fully ManagedVinkius Servers

60%Token savings

High SecurityEnterprise-grade

IAMAccess control

EU AI ActCompliant

DLPData protection

V8 IsolateSandboxed

Ed25519Audit chain

<40msKill switch

Stream every event to Splunk, Datadog, or your own webhook in real-time

* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure

About CoinCap MCP Server

Connect to CoinCap APIs and access real-time cryptocurrency market data through natural conversation — no API key needed.

Mastra's agent abstraction provides a clean separation between LLM logic and CoinCap tool infrastructure. Connect 9 tools through Vinkius and use Mastra's built-in workflow engine to chain tool calls with conditional logic, retries, and parallel execution. deployable to any Node.js host in one command.

What you can do

Asset Prices — Get current prices, market caps, 24h volume and supply info for any cryptocurrency
Asset Search — Search for crypto by name or symbol (Bitcoin, Ethereum, Solana, etc.)
Historical Prices — Retrieve price history with configurable intervals (1m to 1d)
Markets — See which exchanges list specific trading pairs and their 24h volumes
Exchange Rankings — Browse exchanges ranked by 24h volume with verification status
OHLCV Candles — Get candlestick data for technical analysis with multiple timeframes
Exchange Rates — View crypto-to-fiat conversion rates

The CoinCap MCP Server exposes 9 tools through the Vinkius. Connect it to Mastra AI in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.

How to Connect CoinCap to Mastra AI via MCP

Follow these steps to integrate the CoinCap MCP Server with Mastra AI.

Install dependencies

Run npm install @mastra/core @mastra/mcp @ai-sdk/openai

Replace the token

Replace [YOUR_TOKEN_HERE] with your Vinkius token

Run the agent

Save to agent.ts and run with npx tsx agent.ts

Explore tools

Mastra discovers 9 tools from CoinCap via MCP

Why Use Mastra AI with the CoinCap MCP Server

Mastra AI provides unique advantages when paired with CoinCap through the Model Context Protocol.

Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure. add CoinCap without touching business code

Built-in workflow engine chains MCP tool calls with conditional logic, retries, and parallel execution for complex automation

TypeScript-native: full type inference for every CoinCap tool response with IDE autocomplete and compile-time checks

One-command deployment to any Node.js host. Vercel, Railway, Fly.io, or your own infrastructure

CoinCap + Mastra AI Use Cases

Practical scenarios where Mastra AI combined with the CoinCap MCP Server delivers measurable value.

Automated workflows: build multi-step agents that query CoinCap, process results, and trigger downstream actions in a typed pipeline

SaaS integrations: embed CoinCap as a first-class tool in your product's AI features with Mastra's clean agent API

Background jobs: schedule Mastra agents to query CoinCap on a cron and store results in your database automatically

Multi-agent systems: create specialist agents that collaborate using CoinCap tools alongside other MCP servers

CoinCap MCP Tools for Mastra AI (9)

These 9 tools become available when you connect CoinCap to Mastra AI via MCP:

get_asset

Returns the current price in USD, market cap, 24h trading volume, price change percentages (1h, 24h, 7d), circulating supply, total supply, max supply and rank. Asset IDs are lowercase with hyphens (e.g. "bitcoin", "ethereum", "solana"). Get detailed info for a specific cryptocurrency

get_asset_history

Returns daily or interval-based price snapshots. Use interval to specify the data granularity: "m1" (1 minute), "m5" (5 min), "m15" (15 min), "m30" (30 min), "h1" (1 hour), "h2" (2 hours), "h6" (6 hours), "h12" (12 hours), "d1" (1 day). Get historical price data for a cryptocurrency

get_candles

Each candle includes the open, high, low, close prices and volume for the time interval. Supports intervals: "m1", "m5", "m15", "m30", "h1", "h2", "h6", "h12", "d1". Optionally set start/end timestamps (milliseconds since epoch) for historical data. Get OHLCV candlestick data for technical analysis

get_exchange

Returns the exchange name, website, 24h volume, number of markets, rank, verification status and supported assets. Exchange IDs are lowercase (e.g. "binance", "coinbase-pro", "kraken"). Get detailed info for a specific cryptocurrency exchange

get_markets

Each market includes the exchange ID, base asset ID, quote asset ID, trading pair symbol, current price, 24h volume in USD and volume percentage. Optionally filter by asset ID or exchange ID. Get trading markets/pairs for assets or exchanges

get_rate

Returns the current rate for converting the asset to its corresponding fiat currency. Base IDs are typically asset IDs like "bitcoin", "ethereum" or fiat codes like "USD". Get a specific exchange rate

get_rates

). Returns the rate ID, symbol, currency symbol and current rate. Optionally filter by base currency. Get exchange rates for cryptocurrencies to fiat currencies

list_assets

Optionally search by name, filter by specific IDs, and paginate with limit/offset. Returns assets sorted by market cap by default. List cryptocurrency assets with prices and market data

list_exchanges

Each exchange includes its ID, name, website, 24h volume in USD, number of markets, rank and whether it's verified. List cryptocurrency exchanges with rankings