How to Use the CoinMarketCal MCP in LlamaIndex

Q: Can LlamaIndex store CoinMarketCal event data in a vector database?

Yes. Your pipeline can run listevents to fetch the calendar, convert the raw JSON into document nodes, and index them in your vector store for semantic search.

Q: How does the CoinMarketCal agent handle coin name resolution in LlamaIndex?

The agent uses getcoinid to map common coin names to their unique calendar IDs. This ensures that any subsequent tool calls like searcheventsbycoin return accurate results.

Q: Can I filter which tools are exposed to my RAG agent?

Yes, you can use the allowedtools filter when configuring your tool spec. This lets you restrict your agent to specific tools like listtrendingevents if you only want trending data.

Index live crypto events directly into LlamaIndex vector stores to ground your RAG applications in real-world market dates using this MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect CoinMarketCal MCP to LlamaIndex

Create your Vinkius account to connect CoinMarketCal to LlamaIndex 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 CoinMarketCal with LlamaIndex

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build a Searchable Knowledge Base of Crypto Events

Stop querying APIs repeatedly when you can feed `list_events` and `list_popular_events` directly into LlamaIndex to turn ephemeral calendar updates into permanent, searchable knowledge. This lets your query engine retrieve these indexed events to answer complex user questions. Instead of hallucinating dates, the agent retrieves the exact event object. It can also use `get_event_details` when it needs to verify a specific source or proof link.

Query Crypto Schedules via LlamaIndex MCP Server Integration

This MCP Server lets your LlamaIndex agent fetch real-time schedules on demand using `list_categories` and `search_events_by_date` to find the exact match. It eliminates the need to manually sync calendars. The tool output is automatically parsed and embedded into your index. This means your agent can cross-reference live event data with your existing PDFs, newsletters, or market reports for deeper context.

Map Popularity Trends to Specific Digital Assets

Keep your index fresh with what the market cares about right now by running `list_trending_events` and `get_coin_id` to map trending sentiment directly to individual coin profiles in your vector database. Your agent uses `list_coins` to verify ticker symbols before writing new documents to the index. This keeps your data clean and prevents duplicate entries for the same asset under different names.

Setup guide

Set up CoinMarketCal MCP in LlamaIndex

Prerequisites

Python 3.10+ installed
llama-index-tools-mcp package
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run pip install llama-index-tools-mcp llama-index-llms-openai. The MCP tools package provides BasicMCPClient and McpToolSpec.
2

Connect with BasicMCPClient
Point BasicMCPClient to your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. Supports SSE and Streamable HTTP transports.
3

Convert to LlamaIndex tools
Call mcp_tool_spec.to_tool_list_async() to convert all CoinMarketCal MCP tools into native FunctionTool objects that any LlamaIndex agent can use.
4

Run with any LLM
Create a FunctionAgent with the tools and your preferred LLM. Swap OpenAI for Anthropic, Gemini, or any LlamaIndex-supported provider.

agent.py

from llama_index.tools.mcp import BasicMCPClient, McpToolSpec
from llama_index.core.agent.workflow import FunctionAgent
from llama_index.llms.openai import OpenAI

# Connect to the MCP
mcp_client = BasicMCPClient(
    "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
)
mcp_tool_spec = McpToolSpec(client=mcp_client)

# Convert MCP tools to LlamaIndex tools
tools = await mcp_tool_spec.to_tool_list_async()

# Create and run the agent
agent = FunctionAgent(
    tools=tools,
    llm=OpenAI(model="gpt-4o"),
    system_prompt="You have access to CoinMarketCal tools.",
)
response = await agent.run("List recent CoinMarketCal data")

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 CoinMarketCal. 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 CoinMarketCal 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 CoinMarketCal MCP in LlamaIndex

Install llama-index-tools-mcp and set up the BasicMCPClient with your Vinkius URL. Wrap it in McpToolSpec and call to_tool_list_async to pass the tools to your agent.

Yes. Your pipeline can run `list_events` to fetch the calendar, convert the raw JSON into document nodes, and index them in your vector store for semantic search.

The agent uses `get_coin_id` to map common coin names to their unique calendar IDs. This ensures that any subsequent tool calls like `search_events_by_coin` return accurate results.

Yes, you can use the allowed_tools filter when configuring your tool spec. This lets you restrict your agent to specific tools like `list_trending_events` if you only want trending data.

No, the MCP Server only fetches public event listings, coin IDs, and event categories. Your vector database connections, API keys, and private indexes remain entirely local to your LlamaIndex environment.

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