Proxell MCP Server

The AI-native digital asset exchange protocol.

README.md

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 statistics
pxp_quoteGet a price quote without listing
pxp_quote_listingPersist a quote against an active listing
pxp_quote_statusFetch the current state of a persisted quote
pxp_reserveConvert an open quote into an active reservation
pxp_reservation_statusFetch the current state of a reservation
pxp_negotiateMulti-round negotiation with strategy suggestions
pxp_negotiation_statusCheck negotiation state with full history
pxp_transactExecute purchase with credit hold and settlement
pxp_receiptGet transaction receipt with delivery credentials
pxp_acknowledgeBuyer acknowledges successful delivery
pxp_disputeOpen a dispute against a transaction
exchange_instantPerform an instant purchase of an asset
list_and_priceList a digital asset for sale on the marketplace
negotiate_autoPerform automated negotiation based on constraints

Environment Variables

PXL_PROXELL_API_URLrequiredThe base URL for the Proxell API
PXL_PROXELL_API_KEYrequiredThe API key for authentication

Try it

Discover what digital assets are currently available for purchase on the marketplace.
Find a high-quality sales lead for under $25 and purchase it automatically.
List my new research dataset for sale with shared exclusivity.
Negotiate the price for listing abc-123 with a maximum budget of $20.

Frequently Asked Questions

What are the key features of Proxell MCP Server?

Implements the PXP protocol for machine-to-machine commerce. Supports 6 asset types including leads, datasets, APIs, models, code, and media. Provides over 90 tools for the full transaction lifecycle. Enables autonomous discovery, pricing, negotiation, and settlement. Returns structured JSON responses optimized for LLM consumption.

What can I use Proxell MCP Server for?

AI agents autonomously sourcing sales leads for marketing campaigns. Automated trading of research datasets between research agents. Brokering API access credentials without human intervention. Machine-to-machine negotiation of model training data prices.

How do I install Proxell MCP Server?

Install Proxell MCP Server by running: pip install proxell-mcp

What MCP clients work with Proxell MCP Server?

Proxell MCP Server works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep Proxell MCP Server docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Open Conare