Skip to content

Build on PeerX

Call PeerX agents from your own product over the REST API or the Model Context Protocol. A developer account gives you API keys, a sandbox and an API explorer.
Create a developer accountRead the API reference
The API has no public release yet, so endpoints can still change. Releases will be listed in the changelog.
Example request: create a project
curl -X POST https://api.peerx.ai/api/v1/projects \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Wedding planning",
    "agentId": "wedding-event-planner",
    "metadata": { "date": "2024-06-15" }
  }'

What your developer account includes

  • API keys

    Create, rotate and revoke keys. A new key is shown once, when you create it.

  • Sandbox

    Try requests against sandbox projects before you touch real ones.

  • API explorer

    Browse the endpoints your key can call and send test requests from the browser.

  • MCP playground

    Connect to an MCP server and call its tools by hand before you configure a client.

  • Webhooks

    Register the endpoints PeerX calls when something your integration follows changes.

  • Usage and limits

    See your request volume against your rate limits, and ask for a higher limit.

Call it from your code

The same request in JavaScript and Python, and what comes back. Send it from your server; an API key never belongs in a browser or a mobile app.

JavaScript request
// On your server: the key never goes to a browser.
const API = 'https://api.peerx.ai/api/v1'

const res = await fetch(`${API}/projects`, {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.PEERX_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    name: 'Wedding planning',
    agentId: 'wedding-event-planner',
  }),
})
const project = await res.json()
Example response
{
  "id": "proj_123",
  "name": "Wedding planning",
  "status": "active",
  "createdAt": "2024-01-15T10:00:00Z"
}

Guides

Next.jsAbout 15 minutes

Call PeerX from a Next.js app

Keep your key on the server and call the API from a route handler.

  1. Create an API key

    In your developer account, create a key for this app.

  2. Store it on the server

    Add it as PEERX_API_KEY in your environment, never in client code.

  3. Add a route handler

    Call the API from app/api/…/route.ts and return only what the page needs.

MCPAbout 30 minutes

Connect an MCP client

Let Claude Desktop, Cursor or VS Code call PeerX agents as tools.

  1. Find your server

    Your developer account lists the MCP servers your organization can use.

  2. Try its tools

    Call them in the MCP playground to see what they return.

  3. Configure your client

    Add the server address and your token to the client’s MCP settings.

Read the MCP guide

API plans

A separate subscription for building on the PeerX API and MCP server. New developer accounts start on the free plan; the paid API plans are set up with our team.

API Free

Get started with PeerX APIs

Free

  • 1,000 API calls/month
  • 100 MCP sessions/month
  • 5 API keys
  • 5 webhooks
  • 3 sandbox projects
  • Community support
Create a developer account

API Starter

Through our team

For small teams and projects

$29each month

  • 10,000 API calls/month
  • 1,000 MCP sessions/month
  • 20 API keys
  • 20 webhooks
  • 10 sandbox projects
  • Email support
  • GraphQL access
Ask about API Starter

API Professional

Through our team

For growing businesses

$99each month

  • 100,000 API calls/month
  • 10,000 MCP sessions/month
  • 50 API keys
  • 50 webhooks
  • 25 sandbox projects
  • Support agreed with our team
  • GraphQL access
  • Custom rate limits
Ask about API Professional

API Enterprise

For large-scale deployments

Unlimited API calls, Unlimited MCP sessions, 200 API keys, 200 webhooks, 100 sandbox projects, Support agreed with our team, Service levels agreed in your contract, Custom integrations

Ask about API Enterprise

Get your first API key

Create a developer account, then create a key in it. The sandbox is there when you want to try a request first.
Create a developer account