Proxenio MCP Server

MCP (Model Context Protocol) server for the Proxenio verified intent network. Enables AI agents running in Claude Desktop, Cursor, VS Code, and other MCP-compatible clients to discover and interact with Proxenio's professional matching engine.

What It Does

This server gives your AI agent four tools:

Your agent inherits the human principal's trust tier. It sees exactly what the principal sees — same matching engine, same rules, same verification gates. No shortcuts.

Related MCP server: m3x-mcp-server

Prerequisites

• Node.js 18+

• A Proxenio account with a verified email and completed profile

• An API key generated at proxenio.ai/agents

Installation

npx @proxenio-tech/mcp-server

Usage with Claude Desktop

Add to your Claude Desktop configuration (claude_desktop_config.json):

{
  "mcpServers": {
    "proxenio": {
      "command": "npx",
      "args": ["@proxenio-tech/mcp-server"]
    }
  }
}

Then in Claude Desktop, you can say:

"What is Proxenio?"
→ Claude uses proxenio_discover automatically

"Connect to Proxenio with this key: prx_YOUR_KEY_HERE_________________"
→ Claude uses proxenio_set_api_key

"Show me my professional matches"
→ Claude uses proxenio_get_matches

"Accept the introduction from Maria Georgiou"
→ Claude uses proxenio_accept_match

Usage with Cursor

Add to your Cursor MCP settings:

{
  "proxenio": {
    "command": "npx",
    "args": ["@proxenio-tech/mcp-server"]
  }
}

Remote Deployment (HTTP)

For multi-client or cloud deployment:

TRANSPORT=http PORT=3001 node dist/index.js

The server exposes:

• POST /mcp — MCP protocol endpoint

• GET /health — Health check

Tools Reference

proxenio_discover

No authentication required. Returns platform info, trust model, capabilities, and links.

proxenio_set_api_key

proxenio_get_matches

Returns: Principal info, matches with counterparty profiles, trust tiers, scores, and rate limit status.

proxenio_accept_match

Returns: Confirmation, counterparty details, new deal ID, rate limit status.

Guard rails: Principal must be the receiving party. Cannot accept own requests. Match must be active with a pending intro.

Trust Model

• Agents inherit their human principal's trust tier at request time

• Trust tiers: 0 (Unverified) → 1 (Starter) → 2 (Active) → 3 (Trusted) → 4 (Proven)

• All engine verification gates apply — agents cannot bypass any

• Counterparties see transparency badge: 🤖 AI Agent active on behalf of [Name]

• Only humans can log outcomes and confirm deals

Rate Limits

• 60 requests/hour per API key

• 3 keys maximum per user (= 180 requests/hour total)

• Rate limit headers included in all responses

Security

• API keys are never logged or stored by the MCP server

• Keys are validated on format before use (prefix, length)

• All communication uses HTTPS

• The MCP server acts as a pass-through — no data is cached

Links

• Platform: proxenio.ai

• Agent Docs: proxenio.ai/agents/docs

• Discovery Manifest: .well-known/proxenio.json

• OpenAPI Spec: api/agent/openapi.json

License

MIT — Proxenio Technologies Ltd