Kuru.io MCP Server

Kuru.io MCP Server

This project implements a Model Context Protocol (MCP) server for accessing Kuru.io crypto exchange data, making it accessible to LLMs and AI assistants.

Features

• Market Data: Access real-time market data and trending markets
• Tools: Get current prices, calculate token values, and list all trading pairs
• Caching: Built-in caching mechanism to reduce API calls

Demonstration

Below is a demonstration of how to use the Kuru.io MCP server with Claude.

Installation

# Install dependencies
npm install

# Build the project
npm run build

Usage

Starting the server

As a stdio server (for use with LLM tools like Claude Desktop)

npm start

For debugging with MCP Inspector

npm run inspector

MCP Tools

The server provides these tools:

• get-price - Get the current price for a trading pair

  • Parameter: symbol - Trading pair in format BASE/QUOTE (e.g., MON/USDC)
  • Example: "What's the current price of MON/USDC?"

• get-all-trading-pairs - Get all available trading pairs

  • Example: "Show me all trading pairs available on Kuru.io"

• calculate-value - Calculate the value of a token amount in another currency

  • Parameters:
    • symbol - Trading pair in format BASE/QUOTE (e.g., MON/USDC)
    • amount - Amount of the base token
  • Example: "How much is 100 MON worth in USDC?"

Example Usage with Claude

In Claude Desktop

1. Add a new MCP Tool in Claude Desktop
2. Choose "Local Process"
3. Set the command to run the server:

   node /path/to/kuru-mcp-server/dist/index.js
   

4. Save and connect

Now you can use the Kuru.io MCP tools in your conversations with Claude.

Example Prompts

Try asking Claude:

• "What are the trending markets on Kuru.io right now?"
• "Give me information about the MON/USDC market"
• "What's the current price of MON/USDC?"
• "Calculate the value of 100 MON in USDC"
• "Show me all trading pairs available on Kuru.io"

Technical Details

• Built with TypeScript and Node.js
• Uses the Model Context Protocol SDK v1.8.0
• Implements caching to reduce API calls (5-minute TTL)
• Provides comprehensive market data including price, volume, and liquidity information

Credits

This project uses the Kuru.io site API and implements the Model Context Protocol specification.