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

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.

Instant Trading (3 tools)

One-call convenience tools for fast flows.

Exchange Marketplace (6 tools)

Lead Management (4 tools)

Data Enrichment (5 tools)

Lead Scoring (4 tools)

Campaign & Outreach (5 tools)

Compliance & GDPR (4 tools)

Analytics & Reporting (5 tools)

Billing & Credits (5 tools)

Agent Identity (4 tools)

Escrow & Settlement (4 tools)

Subscriptions (4 tools)

Pipeline Automation (6 tools)

Federation (5 tools)

Constraint Negotiation (1 tool)

Situational Awareness (3 tools)

Asset Verticals (8 tools)

Authentication

Proxell supports three authentication methods, resolved in priority order:

1. JWT Bearer Token -- Full tenant context with role-based access
2. Scoped API Keys -- Fine-grained permissions per asset type and action
3. Tenant ID -- Direct tenant identification (development only)

Pass credentials via MCP metadata:

{
  "auth_token": "eyJhbGciOi...",
  "api_key": "pxl_live_...",
  "tenant_id": "uuid"
}

Transport

Proxell MCP runs on Streamable HTTP (port 8100 by default):

• Stateless HTTP transport for horizontal scaling
• JSON responses optimized for LLM consumption
• Idempotency keys on all write operations
• Structured PXP error payloads with fix suggestions and related tool hints

Environment Variables

Architecture

+------------------+       +------------------+       +------------------+
|  Claude Desktop  |       |   Custom Agent   |       |   Other Client   |
|  Cursor / VS Code|       |   (Python/JS)    |       |   (Any MCP)      |
+--------+---------+       +--------+---------+       +--------+---------+
         |                          |                          |
         +------------- MCP (Streamable HTTP) ----------------+
                                    |
                        +-----------+-----------+
                        |   Proxell MCP Server  |
                        |   93 tools / PXP/1.0  |
                        +-----------+-----------+
                                    |
                        +-----------+-----------+
                        |   Proxell Backend     |
                        |   PostgreSQL + Redis  |
                        |   Stripe + Enrichment |
                        +-----------------------+

Self-Hosting

To run your own Proxell instance:

# Clone and install
git clone https://github.com/cvsper/proxell-mcp.git
cd proxell-mcp
pip install -e .

# Configure
export PXL_PROXELL_API_URL=http://localhost:8000
export PXL_PROXELL_API_KEY=your-key

# Run
proxell-mcp

The MCP server connects to a running Proxell backend. See the full deployment guide for backend setup instructions.

Documentation

• Full API Reference
• PXP Protocol Specification
• Agent Integration Guide
• Self-Hosting Guide

License

MIT -- see LICENSE for details.