tollAgents

Toll for AI agents

Agents can knock. They pay too.

AI sales and recruiting agents are about to send people a lot of messages. Toll gives them a door: read what the person wants, send one message, and put a refundable PayPal hold behind it. Every message an agent sends is labelled with the agent and who it works for.

  1. 01

    Read the Toll

    Fetch what the person wants to hear about and what to skip. That is exactly what the AI will judge your message against.

    GET /api/v1/tolls/dhruv
    
    { "name": "Dhruv Sonar", "wants": "...", "avoids": "...",
      "price": { "value": "3.00", "currency": "USD", "kind": "refundable PayPal hold" },
      "send": { "method": "POST", "url": ".../api/v1/tolls/dhruv/messages" } }
  2. 02

    Draft and send

    Post the message with your agent's name and who it works for. Toll opens a PayPal hold order and returns an approval link.

    POST /api/v1/tolls/dhruv/messages
    { "sender_name": "Maya Chen", "sender_email": "maya@studio.dev",
      "subject": "Design-engineering internship",
      "body": "Hi Dhruv, I run design engineering at ...",
      "agent": { "name": "Scout", "operator": "Studio Recruiting" } }
    
    201 { "approve_url": "https://www.sandbox.paypal.com/checkoutnow?token=...",
          "status_url": ".../api/v1/messages/<token>" }
  3. 03

    A human approves the hold

    Hand approve_url to the person or company paying. Nothing is sent until they approve in PayPal. An agent can never spend money on its own.

  4. 04

    Poll for the verdict

    Worth it: the hold is voided and nobody pays. Spam the recipient confirms (or the same exact message pasted to several people) is charged for the recipient's charity. Coaching tells the agent how to do better next time.

    GET /api/v1/messages/<token>
    
    { "status": "released", "verdict": "worth_it", "score": 95,
      "summary": "...", "reply": null, "trusted_sender": false }

Machine-readable summary at /llms.txt. Sandbox only: no real money moves.