Connect Coinmarketcal to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.
Ask your agent in plain language. Each of these maps to a real tool on the server.
Use the search events tool in Coinmarketcal
Use the list coins tool in Coinmarketcal
Use the list categories tool in Coinmarketcal
Use the get api usage tool in Coinmarketcal
Use the search coins tool in Coinmarketcal
Use the get event tool in Coinmarketcal
Supported Tools
search_events
Search Events
DEPRECATED — use `list_events` instead. Search and filter cryptocurrency events from the CoinMarketCal calendar. Supports filtering by date range, specific coins, event categories, and sorting preferences. Results include event details, associated coins, community confidence scores, and source links.
list_coins
List Coins
DEPRECATED — use `search_coins` instead. Retrieve the complete list of cryptocurrencies tracked by CoinMarketCal. Useful for discovering which coins have events and for getting correct coin names to use when searching events.
list_categories
List Categories
DEPRECATED — use `list_event_categories` instead. Retrieve all available event categories from CoinMarketCal. Categories represent types of events such as exchange listings, airdrops, hard forks, partnerships, and updates. Use the returned category IDs when filtering events with the Search Events tool.
get_usage
Get API Usage
Read the active plan, monthly request consumption, remaining quota, and reset time for the authenticated CoinMarketCal V2 API key. Requires a V2 API key.
search_coins
Search Coins
Search or browse the CoinMarketCal V2 coin catalog to discover canonical coin slugs, editorial coverage, and upcoming event counts. Returns one page ordered by market-cap rank. Requires a V2 API key.
get_event
Get Event
Retrieve a current CoinMarketCal V2 event by its ID from list_events. Available fields depend on the plan. A removed event returns 410; unknown or out-of-window events return 404.
get_coin
Get Coin
Retrieve a CoinMarketCal V2 coin by its canonical slug from search_coins, including coverage and upcoming event counts. Requires a V2 API key.
list_events
List Events
Search the current CoinMarketCal V2 event catalog by coin, category, date, keyword, or impact. Returns one page with a cursor for the next page. Requires a V2 API key.
list_event_categories
List Event Categories
List the CoinMarketCal V2 category taxonomy and upcoming event counts. Use the returned string IDs with list_events. Requires a V2 API key and Standard or higher plan.
list_event_cancellations
List Event Cancellations
List permanently removed CoinMarketCal V2 events so a saved calendar can remove stale entries. Available on every V2 plan. Results are ordered by cancellation time and event ID.
Enable Coinmarketcal in Metorial. In your Metorial portal, enable the Coinmarketcal MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
Sign in. Select Add and sign in to load Coinmarketcal tools.
Enable Coinmarketcal in Metorial. In your Metorial portal, enable the Coinmarketcal MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add a custom MCP server. On ChatGPT web, open Plugins, select +, then Add custom MCP server.
Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>), choose OAuth and accept the risk notice.
Create and install the plugin. Select Create as a plugin, install it and sign in to load Coinmarketcal tools.
Enable Coinmarketcal in Metorial. In your Metorial portal, enable the Coinmarketcal MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add Metorial to your MCP config. Use ~/.cursor/mcp.json for every project, or .cursor/mcp.json for one.
Sign in. Open Customize in the sidebar, find Metorial and sign in to load Coinmarketcal tools.
{
"mcpServers":{
"metorial":{
"url":"<your-magic-mcp-url>"
}
}
}
Enable Coinmarketcal in Metorial. In your Metorial portal, enable the Coinmarketcal MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add the server over HTTP. Add --scope user to use it in every project.
Sign in. Run /mcp, select Metorial and sign in to load Coinmarketcal tools.
claude mcp add --transport http metorial <your-magic-mcp-url>
Enable Coinmarketcal in Metorial. In your Metorial portal, enable the Coinmarketcal MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add the server and sign in. The Codex CLI, IDE extension and ChatGPT desktop app share this config.
Check the connection. Type /mcp in Codex to see Metorial and its Coinmarketcal tools.
codex mcp add metorial --url <your-magic-mcp-url>
codex mcp login metorial
Run Coinmarketcal through the Metorial gateway
One governed layer for every app your agents reach, not a separate connector per tool.
Give Coinmarketcal and every other app to your whole team through one MCP gateway, behind your SSO.
Scope which teams and agents can use Coinmarketcal tools with role-based access control, and trace every call.
Prefer to run it yourself? Metorial is open source and self-hostable.
Search the CoinMarketCal V2 cryptocurrency event catalog by coin, date range, category, keyword, or impact. Retrieve event details, discover coins and categories, reconcile cancelled events, and read the authenticated API plan and monthly usage. Requires a V2 API key; data access depends on the plan.
Frequently asked questions
Common questions about connecting Coinmarketcal to AI agents with Metorial.
How many tools does the Coinmarketcal MCP server have?
The Coinmarketcal MCP server exposes 10 tools, including Search Events, List Coins, List Categories. Each one is governed and traced through Metorial.
Does the Coinmarketcal MCP server support triggers?
Coinmarketcal exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
Which AI clients can use the Coinmarketcal MCP server?
Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Coinmarketcal MCP server through the same Metorial URL.
How do I give only some teams access to Coinmarketcal?
Use role-based access control to decide which teams, users, and agents can use Coinmarketcal and which of its tools they can call.
Can I self-host the Coinmarketcal MCP server?
Yes. Metorial is open source, so you can run the Coinmarketcal MCP server yourself or use the hosted gateway.
Connect Coinmarketcal to production AI agents
See how Metorial gives your team governed access to Coinmarketcal, with tracing and security controls built in.