Skip to main content

Mirror AI MCP Client SDK — Connect to 100+ crypto intelligence tools

Project description

Mirror MCP SDK

Official Python SDK for the Mirror AI MCP Server — access 100+ crypto intelligence tools via REST API.

What's New in v4.2.1

Universal Tool Execution — Execute any of 100+ MCP tools directly via REST API:

# Get Bitcoin price
result = client.execute_tool("get_symbol_price", {"symbol": "BTC"})
print(result["result"][0]["price"])

# List all available tools
tools = client.list_tools()
for tool in tools:
    print(f"{tool['name']}: {tool['description']}")

Installation

pip install mirror-mcp

Quick Start

from mirror_mcp import MirrorMCPClient

# Create client (reads MIRROR_API_KEY from env if not provided)
client = MirrorMCPClient(api_key="gl_mcp_...")

# List all 100+ executable tools
tools = client.list_tools()
for tool in tools:
    print(f"{tool['name']}: {tool['description']}")

# Execute any tool
result = client.execute_tool("get_symbol_price", {"symbol": "BTC"})
print(result["result"][0]["price"])

# Get market data
result = client.execute_tool("get_current_market_data", {"limit": 10})
for coin in result["result"]:
    print(f"{coin['symbol']}: ${coin['price']}")

# DeFi tools
result = client.execute_tool("query_defi_protocols", {"protocol": "Aave"})

# Security analysis
result = client.execute_tool("analyze_token_security", {"symbol": "ETH"})

# Compliance
result = client.execute_tool("compliance_search_documents", {"query": "MiCA"})

Authentication

Get your API key from mirror.glasslane.io:

export MIRROR_API_KEY="your-api-key"

Available Tool Categories

  • market — Prices, volume, technical indicators, top movers
  • defi — Protocols, yield farming, liquidity pools
  • security — Token security, contract analysis
  • compliance — Regulations, documents, risk assessment
  • analytics — Price correlation, momentum, volatility
  • blockchain — Wallet analysis, transaction patterns
  • arbitrage — Cross-DEX arbitrage opportunities
  • nft — NFT collections, ownership, whale tracking
  • alerts — Price alerts, market signals
  • research — Token research, whitepaper analysis

CLI Usage

# Check server health
mirror-mcp health

# List all 100+ tools
mirror-mcp tools

# List tools by category
mirror-mcp tools --category market

# Execute any tool
mirror-mcp call get_symbol_price '{"symbol": "BTC"}'
mirror-mcp call get_current_market_data

# Show API key permissions
mirror-mcp permissions

# Legacy: list skills/prompts (still supported)
mirror-mcp list-skills
mirror-mcp list-skills --category defi

Async Support

import asyncio
from mirror_mcp import MirrorMCPClient

async def get_prices():
    async with MirrorMCPClient(api_key="...") as client:
        # List tools
        tools = await client.list_tools_async()
        
        # Execute multiple tools concurrently
        results = await asyncio.gather(
            client.execute_tool_async("get_symbol_price", {"symbol": "BTC"}),
            client.execute_tool_async("get_symbol_price", {"symbol": "ETH"}),
            client.execute_tool_async("get_symbol_price", {"symbol": "SOL"}),
        )
        return results

asyncio.run(get_prices())

Error Handling

from mirror_mcp import MirrorMCPClient, AuthenticationError, ToolExecutionError

try:
    client = MirrorMCPClient(api_key="your-key")
    result = client.execute_tool("get_symbol_price", {"symbol": "BTC"})
except AuthenticationError as e:
    print(f"Authentication failed: {e}")
except ToolExecutionError as e:
    print(f"Tool execution failed: {e}")

Documentation

License

MIT License — Copyright © 2025 Glass Lane Pty Ltd

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mirror_mcp-4.2.1.tar.gz (253.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mirror_mcp-4.2.1-py3-none-any.whl (245.4 kB view details)

Uploaded Python 3

File details

Details for the file mirror_mcp-4.2.1.tar.gz.

File metadata

  • Download URL: mirror_mcp-4.2.1.tar.gz
  • Upload date:
  • Size: 253.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for mirror_mcp-4.2.1.tar.gz
Algorithm Hash digest
SHA256 acbf58dfcd05df13407b74dcde617394f61bbd6f54fc6113b5a1649ee73f9c01
MD5 93a45f928f1ce724c35f247a7bde8317
BLAKE2b-256 701861ac7ea72182b39be899bc0cd17e47b2e07e7c2d56ca79766f2d2b986f18

See more details on using hashes here.

File details

Details for the file mirror_mcp-4.2.1-py3-none-any.whl.

File metadata

  • Download URL: mirror_mcp-4.2.1-py3-none-any.whl
  • Upload date:
  • Size: 245.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for mirror_mcp-4.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 c213ba168ccbab4e8dad6b5654aa5f18ff98160ff1eb9bed6b50ca66b3b78cb3
MD5 3d80911e88c82c618df4a1888c713695
BLAKE2b-256 fb23aefdaff9f679e375a2c8e4f9e0a5d8e5e6937ea6ad9e06270c1b1f8fb510

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page