aimarket-mcp-server

ai.market MCP Server

MCP (Model Context Protocol) server for the ai.market data marketplace. Enables LLM clients like Claude Desktop, Cursor, and Cline to search, evaluate, and purchase datasets.

Features

• Search datasets by natural language query
• Get detailed information about datasets including schema, pricing, and compliance
• Preview sample data before purchasing
• Check wallet balance and manage funds
• Purchase datasets directly from your LLM client
• Access purchased data via signed download URLs
• Sandbox mode for testing without real charges

Installation

Option 1: Install from PyPI

pip install aimarket-mcp-server

Option 2: Install from source

git clone https://github.com/maxrobbins/aimarket-mcp-server.git
cd aimarket-mcp-server
pip install -e .

Configuration

Environment Variables

Getting an API Key

1. Sign up at ai.market
2. Go to Settings → API Keys
3. Create a new API key
4. Copy the key and set it as AIMARKET_API_KEY

Sandbox Mode

For testing without real charges, enable sandbox mode:

export AIMARKET_SANDBOX=true

In sandbox mode:

• Uses mock datasets (5 sample datasets)
• $1,000 fake wallet balance
• No real purchases or charges

Claude Desktop Configuration

Add to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "aimarket": {
      "command": "python",
      "args": ["-m", "aimarket_mcp.server"],
      "env": {
        "AIMARKET_API_KEY": "your_api_key_here"
      }
    }
  }
}

Or for sandbox mode:

{
  "mcpServers": {
    "aimarket": {
      "command": "python",
      "args": ["-m", "aimarket_mcp.server"],
      "env": {
        "AIMARKET_SANDBOX": "true"
      }
    }
  }
}

Then restart Claude Desktop.

Available Tools

Discovery

Transactions

Utility

Usage Examples

Once configured, you can use natural language with Claude:

"Search for e-commerce transaction datasets"

"Show me the details for dataset 00000000-0000-0000-0000-000000000001"

"Check my wallet balance"

"Purchase the financial market dataset" (requires confirmation)

"List my recent orders"

Security

• API keys are never logged or exposed in tool outputs
• Purchase operations require explicit confirmation
• Sandbox mode prevents accidental real purchases
• All API communications use HTTPS

Development

# Clone the repository
git clone https://github.com/maxrobbins/aimarket-mcp-server.git
cd aimarket-mcp-server

# Create virtual environment
python -m venv venv
source venv/bin/activate  # or `venv\Scripts\activate` on Windows

# Install in development mode
pip install -e ".[dev]"

# Run tests
pytest

License

MIT License - see LICENSE for details.

Support

• Documentation: docs.ai.market
• Issues: GitHub Issues
• Email: support@ai.market