Proxenio 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:

Tool	What it does
proxenio_discover	Learn about the platform, trust model, and API — no auth required
proxenio_set_api_key	Configure your Proxenio API key for authentication
proxenio_get_matches	Read your principal's verified professional matches
proxenio_accept_match	Accept an introduction request, creating a deal

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.

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

Parameter	Type	Required	Description
api_key	string	Yes	Full API key (36 chars, starts with prx_)

proxenio_get_matches

Parameter	Type	Default	Description
filter_type	all|top|high|standard	all	Filter by match quality
filter_status	all|pending|accepted	all	Filter by status
min_score	number (40-100)	40	Minimum match score

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

proxenio_accept_match

Parameter	Type	Required	Description
match_id	string (UUID)	Yes	Match ID from proxenio_get_matches

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