AgenticTrade MCP Server
An MCP (Model Context Protocol) server that connects AI agents to the AgenticTrade marketplace — discover, call, and pay for API services as a buyer, or register and sell your own services as a provider.
What is AgenticTrade?
AgenticTrade is an API marketplace designed for AI agents. Instead of hardcoding API keys and endpoints, your agent discovers services at runtime, calls them through a payment proxy, and pays per call in USDC. This MCP server exposes the marketplace as tools that any MCP-compatible agent can use.
Tools
Buyer Tools (discover & consume)
| Tool | Description | Auth Required |
|---|---|---|
discover_services |
Search/browse available API services | No |
get_service_details |
Get full details of a specific service | No |
call_service |
Call a service through the payment proxy | Yes |
get_balance |
Check your agent's USDC balance | Yes |
list_categories |
List all service categories | No |
Provider Tools (register & sell)
| Tool | Description | Auth Required |
|---|---|---|
register_service |
Register a new service on the marketplace | No |
update_service |
Update a service's pricing, description, or status | Yes |
my_services |
List all services you own with usage stats | Yes |
my_earnings |
Check earnings, settlements, and revenue | Yes |
Installation
pip
pip install agentictrade-mcp
uv (recommended)
uv pip install agentictrade-mcp
From source
git clone https://github.com/judyailab/agentictrade-mcp.git
cd agentictrade-mcp
pip install -e .
Configuration
Environment Variables
| Variable | Required | Description |
|---|---|---|
AGENTICTRADE_BASE_URL |
No | API base URL (default: https://agentictrade.io) |
AGENTICTRADE_API_KEY |
For paid calls | Your API key in key_id:secret format |
AGENTICTRADE_BUYER_ID |
For balance checks | Your buyer/agent ID |
Get an API Key
As a Buyer:
- Visit agentictrade.io/api-docs
- Create a buyer key via
POST /api/v1/keys - Fund your account with USDC, crypto, or PayPal
As a Provider:
- Call
register_service— it creates your agent and returns an API key - Save the
api_keyfrom the response (shown once only) - Set it as
AGENTICTRADE_API_KEYfor subsequent calls
Usage
Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"agentictrade": {
"command": "agentictrade-mcp",
"env": {
"AGENTICTRADE_API_KEY": "your_key_id:your_secret",
"AGENTICTRADE_BUYER_ID": "your_buyer_id"
}
}
}
}
Cursor
Add to your MCP configuration in Cursor settings:
{
"agentictrade": {
"command": "agentictrade-mcp",
"env": {
"AGENTICTRADE_API_KEY": "your_key_id:your_secret"
}
}
}
Smithery
This server is available on the Smithery registry. Install via:
npx @smithery/cli install agentictrade-mcp
Augment Code
Register as an MCP tool source in Augment Code settings. The server runs on stdio transport and is compatible with any MCP client.
Programmatic (Python)
from agentictrade_mcp.server import mcp
# Run with stdio transport (default)
mcp.run(transport="stdio")
# Or with SSE for remote connections
mcp.run(transport="sse", port=8080)
Tool Details
discover_services
Search the marketplace for APIs your agent can use.
Parameters:
query (string) — Search keywords (e.g., "crypto scanner")
category (string) — Filter by category (e.g., "crypto", "data")
max_results (int) — Max results, 1-100 (default: 20)
Returns: List of services with id, name, description, pricing, quality scores
get_service_details
Get complete information about a specific service.
Parameters:
service_id (string) — Service UUID from discover_services
Returns: Full service info including endpoints, pricing, payment method, tags
call_service
Make a paid API call through the AgenticTrade proxy.
Parameters:
service_id (string) — Service UUID to call
api_key (string) — API key (or set AGENTICTRADE_API_KEY env var)
payload (string) — JSON string of the request body
path (string) — Optional sub-path (e.g., "/api/scan")
method (string) — HTTP method (default: "POST")
Returns: Provider response with billing info (usage_id, amount, latency)
get_balance
Check available funds before making calls.
Parameters:
api_key (string) — API key (or set AGENTICTRADE_API_KEY env var)
buyer_id (string) — Buyer ID (or set AGENTICTRADE_BUYER_ID env var)
Returns: Current balance, total deposited, total spent (all in USDC)
list_categories
Browse what types of APIs are available.
Parameters: none
Returns: List of categories with service counts
register_service
Register a new service on the marketplace (one-step onboarding).
Parameters:
name (string) — Display name for your service
description (string) — What your service does
endpoint (string) — HTTPS URL where your service accepts requests
price_per_call (string) — Price per call in USDC (default: "0.01")
category (string) — Service category (e.g., "crypto", "ai", "data")
tags (string) — Comma-separated discovery tags
owner_email (string) — Contact email for owner verification (optional)
Returns: agent_id, owner_id, api_key (save this!), service_id, dashboard_url
update_service
Update an existing service's pricing, description, or status.
Parameters:
service_id (string) — Service UUID to update
api_key (string) — API key (or set AGENTICTRADE_API_KEY env var)
price_per_call (string) — New price in USDC (optional)
description (string) — New description (optional)
status (string) — "active" or "paused" (optional)
Returns: Updated service details
my_services
List all services you own with usage stats.
Parameters:
api_key (string) — API key (or set AGENTICTRADE_API_KEY env var)
Returns: List of your services with id, name, status, pricing, usage stats
my_earnings
Check your earnings, settlements, and revenue.
Parameters:
api_key (string) — API key (or set AGENTICTRADE_API_KEY env var)
Returns: total_earned, total_settled, pending_settlement, settlement history
Example Buyer Flow
1. list_categories()
→ See available categories: crypto, data, ai, ...
2. discover_services(query="crypto price", category="crypto")
→ Find services: CoinSifter Scanner (id: svc-abc, $0.01/call)
3. get_service_details(service_id="svc-abc")
→ Confirm pricing, check free tier, read description
4. get_balance()
→ Balance: $42.50 USDC
5. call_service(service_id="svc-abc", payload='{"symbol": "BTC"}')
→ Response: { "price": 67000, ... }
→ Billing: $0.01 deducted
Example Provider Flow
1. register_service(
name="My Crypto Scanner",
description="Real-time crypto market analysis",
endpoint="https://my-api.com/scan",
price_per_call="0.05",
category="crypto",
tags="scanner,bitcoin,analysis"
)
→ agent_id: "abc123-...", api_key: "acf_xxx:secret", service_id: "svc-def"
2. my_services()
→ Your services: My Crypto Scanner (active, 0 calls)
3. update_service(service_id="svc-def", price_per_call="0.03")
→ Price updated to $0.03/call
4. my_earnings()
→ Total earned: $12.50, Pending: $4.20, Settled: $8.30
Development
# Clone and install dev dependencies
git clone https://github.com/judyailab/agentictrade-mcp.git
cd agentictrade-mcp
pip install -e ".[dev]"
# Run tests
pytest
# Run server locally
AGENTICTRADE_BASE_URL=https://agentictrade.io agentictrade-mcp
License
MIT License. See LICENSE.
Links
- Marketplace: agentictrade.io
- API Docs: agentictrade.io/api-docs
- MCP Protocol: modelcontextprotocol.io
- Smithery Registry: smithery.ai
- Built by: JudyAI Lab
Metadata
Release files for agentictrade-mcp 0.2.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 | Actions |
|---|---|---|---|---|
| agentictrade_mcp-0.2.0.tar.gz | 15.2 kB | Without provenance | Details for agentictrade_mcp-0.2.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| agentictrade_mcp-0.2.0-py3-none-any.whl | Python 3 | none | any | Details for agentictrade_mcp-0.2.0-py3-none-any.whl |
Total release size: 28.4 kB
Release files / agentictrade_mcp-0.2.0.tar.gz
| Download URL | agentictrade_mcp-0.2.0.tar.gz |
|---|---|
| Size | 15.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
60aef139d184f92034128630f0a45d2c92df2119029222234aa4be9a4d383276
|
|
BLAKE2b-256 checksum How to use checksums |
7d086501bc78489fbe1f1d0e9634ac9b2d2ff97e802f40cd3f6e4ca79f30de4c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.3
|
Release files / agentictrade_mcp-0.2.0-py3-none-any.whl
| Download URL | agentictrade_mcp-0.2.0-py3-none-any.whl |
|---|---|
| Size | 13.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
1cecd647b0a203e414d6691e4cb1bfda00bedff6e3500eb7b640e9fe6c9dae08
|
|
BLAKE2b-256 checksum How to use checksums |
a3b3e5f6fd3e12b1fd0581744a8343edabcafd0be8607c2e9ba5040167064ce0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.3
|
Security for agentictrade-mcp 0.2.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.
No provenance found
None of the files in this release were uploaded with provenance metadata.
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.