aimarket-mcp-server 0.1.0

MCP Server for ai.market - Search, evaluate, and purchase datasets

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

Variable	Description	Default
AIMARKET_API_KEY	Your ai.market API key	None
AIMARKET_SANDBOX	Enable sandbox mode	false
AIMARKET_BASE_URL	API base URL	Production URL
AIMARKET_TIMEOUT	Request timeout (seconds)	30

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

Tool	Description
search_datasets	Search for datasets by natural language query
get_dataset	Get detailed information about a dataset
evaluate_dataset	Get schema, statistics, and compliance info
preview_dataset	Get sample rows from a dataset

Transactions

Tool	Description
check_wallet	Get current wallet balance
purchase_dataset	Purchase a dataset (requires confirmation)
list_orders	List your orders
get_order_data	Get download URL for purchased data

Utility

Tool	Description
verify_connection	Test API connection and credentials

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: [e-mail]