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
- Sign up at ai.market
- Go to Settings → API Keys
- Create a new API key
- 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: support@ai.market
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)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| aimarket_mcp_server-0.1.0.tar.gz | 7.4 kB | With provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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 logRelease 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 logSecurity 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.
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 logA 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.