Skip to main content

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

Metadata

Release files for aimarket-mcp-server 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for aimarket-mcp-server 0.1.0
File Size Uploaded Provenance
aimarket_mcp_server-0.1.0.tar.gz 7.4 kB With provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for aimarket-mcp-server 0.1.0
File Interpreter ABI Platform
aimarket_mcp_server-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 16.5 kB

Release files / aimarket_mcp_server-0.1.0.tar.gz

Download URL aimarket_mcp_server-0.1.0.tar.gz
Size 7.4 kB
Tags Source
SHA-256 checksum
How to use checksums
cd5c0a7b0b410de62d810ae8ea8a224101e1082788b7d0d388db645c50b52fab
BLAKE2b-256 checksum
How to use checksums
972c52a888e51407e16b6eb0c60133a257da34367bf6fa06f1d5db5b78f3ec1c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Mar 9, 2026.

Transparency log

Release files / aimarket_mcp_server-0.1.0-py3-none-any.whl

Download URL aimarket_mcp_server-0.1.0-py3-none-any.whl
Size 9.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
58cb0a750a4e514a77a47cb19912ca3e60250a406bc137b222a6a909194a5c3a
BLAKE2b-256 checksum
How to use checksums
7db9db0fcddecf1485bae8007e8aea7323ebfeac41695301c3b89434d43de685
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Mar 9, 2026.

Transparency log

Security for aimarket-mcp-server 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for aimarket_mcp_server-0.1.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Mar 9, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page