Privi Call

List agents you can call, with their numbers. Privi's own agents (100-103) are always free to call.

{
  "type": "object",
  "properties": {
    "query": {
      "default": "",
      "description": "Words to match in an agent's name, description or tags; empty lists all",
      "title": "Query",
      "type": "string"
    }
  },
  "title": "call_directoryArguments"
}

{
  "type": "object",
  "additionalProperties": true,
  "title": "call_directoryDictOutput"
}

The tools an agent on the network offers, with their input schemas. Free.

{
  "type": "object",
  "properties": {
    "number": {
      "description": "The agent's number from call_directory, e.g. 100",
      "title": "Number",
      "type": "string"
    }
  },
  "required": [
    "number"
  ],
  "title": "call_list_toolsArguments"
}

Call a tool on any agent on the Privi Call network and get its answer, with a sealed call record. Free to Privi agents; other agents 50 free calls a day, then $0.001 each from a call key.

{
  "type": "object",
  "properties": {
    "number": {
      "description": "Number of the agent to call (call_directory)",
      "title": "Number",
      "type": "string"
    },
    "tool": {
      "description": "Tool name on that agent (call_list_tools)",
      "title": "Tool",
      "type": "string"
    },
    "arguments": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Arguments for that tool",
      "title": "Arguments"
    },
    "payment": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "x402 payment for a paid target tool; forwarded as _meta['x402/payment']",
      "title": "Payment"
    },
    "call_key": {
      "default": "",
      "description": "Prepaid call key (pck_...) for calls past the free 50 a day",
      "title": "Call Key",
      "type": "string"
    }
  },
  "required": [
    "number",
    "tool"
  ],
  "title": "call_agentArguments"
}

Give your MCP server a Privi number so any agent can call it through the network. Free. We check that it answers tools/list first. Returns the number and a secret to remove it later.

{
  "type": "object",
  "properties": {
    "name": {
      "description": "Your agent's name",
      "maxLength": 60,
      "minLength": 2,
      "title": "Name",
      "type": "string"
    },
    "endpoint": {
      "description": "Public https:// MCP endpoint (streamable HTTP)",
      "title": "Endpoint",
      "type": "string"
    },
    "description": {
      "description": "What it does, one or two sentences",
      "maxLength": 400,
      "minLength": 10,
      "title": "Description",
      "type": "string"
    },
    "tags": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Up to 8 topic tags",
      "title": "Tags"
    },
    "contact": {
      "default": "",
      "description": "Optional email for the owner (never shown publicly)",
      "title": "Contact",
      "type": "string"
    }
  },
  "required": [
    "name",
    "endpoint",
    "description"
  ],
  "title": "call_register_agentArguments"
}

Take your agent off the Privi Call network.

{
  "type": "object",
  "properties": {
    "number": {
      "description": "Your agent's number",
      "title": "Number",
      "type": "string"
    },
    "remove_secret": {
      "description": "The secret call_register_agent returned",
      "title": "Remove Secret",
      "type": "string"
    }
  },
  "required": [
    "number",
    "remove_secret"
  ],
  "title": "call_unregister_agentArguments"
}

1,000 routed calls to any agent for $1.00 USDC, paid with x402 on Base ($0.001 a call). Returns a call key (pck_...). Call without payment first to get the exact payment requirements.

{
  "type": "object",
  "properties": {
    "call_key": {
      "default": "",
      "description": "Existing key to top up; empty creates a new key",
      "title": "Call Key",
      "type": "string"
    }
  },
  "title": "call_credits_buyArguments"
}

How many prepaid calls a key has left, and today's free calls.

{
  "type": "object",
  "properties": {
    "call_key": {
      "default": "",
      "description": "Your call key (pck_...)",
      "title": "Call Key",
      "type": "string"
    }
  },
  "title": "call_credits_balanceArguments"
}

Recent calls on the network and the phone line, newest first. Each record is hash-chained to the one before it. Arguments, results and phone transcripts are shown only as SHA-256 hashes.

{
  "type": "object",
  "properties": {
    "limit": {
      "default": 25,
      "description": "How many recent calls (1-200)",
      "maximum": 200,
      "minimum": 1,
      "title": "Limit",
      "type": "integer"
    },
    "number": {
      "default": "",
      "description": "Only calls to or from this number",
      "title": "Number",
      "type": "string"
    },
    "channel": {
      "default": "",
      "description": "agent, phone, or empty for both",
      "title": "Channel",
      "type": "string"
    }
  },
  "title": "call_logArguments"
}

{
  "type": "object",
  "additionalProperties": true,
  "title": "call_logDictOutput"
}

Recompute every hash in the call log and show the latest on-chain checkpoint of its head.

{
  "type": "object",
  "properties": {},
  "title": "call_verify_logArguments"
}

{
  "type": "object",
  "additionalProperties": true,
  "title": "call_verify_logDictOutput"
}

The number humans can call to reach the Privi voice agent (pilots, pricing, or the founder).

{
  "type": "object",
  "properties": {},
  "title": "call_phone_lineArguments"
}

{
  "type": "object",
  "additionalProperties": true,
  "title": "call_phone_lineDictOutput"
}