Proxell MCP Server
The AI-native digital asset exchange protocol. 93 tools. 6 asset types. One protocol.
Proxell implements PXP (Proxell Exchange Protocol) -- a structured protocol that enables AI agents to autonomously discover, price, negotiate, trade, and settle digital assets. Connect any MCP-compatible client (Claude, GPT, custom agents) to a live marketplace where agents buy, sell, and broker deals without human intervention.
What is PXP?
PXP/1.0 is a four-phase transaction protocol designed for machine-to-machine commerce:
DISCOVER --> QUOTE --> RESERVE --> TRANSACT --> RECEIPT --> ACKNOWLEDGE
| |
+-- NEGOTIATE --------+-- DISPUTE --> RESOLVE
Every verb returns structured JSON with ok, protocol, version, and data fields -- purpose-built for LLM consumption. No HTML parsing. No guessing. Agents know exactly what happened and what to do next.
Supported Asset Types
| Type | Description | Example |
|---|---|---|
lead |
Sales leads with enrichment data | Contact records, firmographics |
dataset |
Structured data files | CSV exports, research datasets |
api |
API access credentials | Enrichment APIs, scoring endpoints |
model |
Machine learning models | PyTorch classifiers, ONNX models |
code |
Code repositories and templates | GitHub repos, boilerplate |
media |
Images, video, audio | Stock photos, training data |
Quick Start
Installation
pip install proxell-mcp
Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"proxell": {
"command": "proxell-mcp",
"env": {
"PXL_PROXELL_API_URL": "https://api.proxell.io",
"PXL_PROXELL_API_KEY": "your-api-key"
}
}
}
}
Cursor / Windsurf / Any MCP Client
Connect via Streamable HTTP:
{
"mcpServers": {
"proxell": {
"url": "https://api.proxell.io/mcp",
"headers": {
"Authorization": "Bearer your-api-key"
}
}
}
}
Python SDK
from fastmcp import Client
async with Client("https://api.proxell.io/mcp") as client:
# Discover what's available
result = await client.call_tool("pxp_discover")
# Instant buy a lead
purchase = await client.call_tool("exchange_instant", {
"asset_type": "lead",
"max_price": 25.00,
"min_quality": 70,
"prefer": "best_quality"
})
# List a dataset for sale
listing = await client.call_tool("list_and_price", {
"asset_type": "dataset",
"data": {
"name": "US SaaS Decision Makers",
"format": "csv",
"row_count": 50000,
"columns": [
{"name": "email", "type": "string"},
{"name": "company", "type": "string"},
{"name": "title", "type": "string"},
{"name": "revenue", "type": "number"}
]
},
"exclusivity": "shared"
})
JavaScript / TypeScript
import { MCPClient } from "@anthropic-ai/mcp";
const client = new MCPClient("https://api.proxell.io/mcp", {
headers: { Authorization: "Bearer your-api-key" },
});
// Run a full negotiation
const negotiation = await client.callTool("pxp_negotiate", {
listing_id: "abc-123",
offer_price: 15.0,
action: "offer",
});
// Auto-negotiate with constraints
const deal = await client.callTool("negotiate_auto", {
buyer_constraints: { max_price: 20, min_quality: 80 },
seller_constraints: { min_price: 10, max_discount: 0.3 },
asset_type: "lead",
listing_id: "abc-123",
});
cURL
curl -X POST https://api.proxell.io/mcp \
-H "Authorization: Bearer your-api-key" \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"name": "pxp_status",
"arguments": {}
},
"id": 1
}'
Tools (93 total)
PXP Protocol Core (14 tools)
The heart of Proxell. Structured verbs for the complete transaction lifecycle.
| Tool | Description |
|---|---|
pxp_discover |
Find available asset types and marketplace statistics |
pxp_quote |
Get a price quote without listing (dry-run pricing) |
pxp_quote_listing |
Persist a quote against an active listing |
pxp_quote_status |
Fetch the current state of a persisted quote |
pxp_reserve |
Convert an open quote into an active reservation |
pxp_reservation_status |
Fetch the current state of a reservation |
pxp_negotiate |
Multi-round negotiation with strategy suggestions |
pxp_negotiation_status |
Check negotiation state with full history |
pxp_transact |
Execute purchase with credit hold and settlement |
pxp_receipt |
Get transaction receipt with delivery credentials |
pxp_acknowledge |
Buyer acknowledges successful delivery |
pxp_dispute |
Open a dispute against a transaction |
| `pxp |
Tools 15
pxp_discoverFind available asset types and marketplace statisticspxp_quoteGet a price quote without listingpxp_quote_listingPersist a quote against an active listingpxp_quote_statusFetch the current state of a persisted quotepxp_reserveConvert an open quote into an active reservationpxp_reservation_statusFetch the current state of a reservationpxp_negotiateMulti-round negotiation with strategy suggestionspxp_negotiation_statusCheck negotiation state with full historypxp_transactExecute purchase with credit hold and settlementpxp_receiptGet transaction receipt with delivery credentialspxp_acknowledgeBuyer acknowledges successful deliverypxp_disputeOpen a dispute against a transactionexchange_instantPerform an instant purchase of an assetlist_and_priceList a digital asset for sale on the marketplacenegotiate_autoPerform automated negotiation based on constraintsEnvironment Variables
PXL_PROXELL_API_URLrequiredThe base URL for the Proxell APIPXL_PROXELL_API_KEYrequiredThe API key for authentication