PostBridge AI

{
  "did": "did:web:postbridge.ai",
  "logo": "https://postbridge.ai/assets/avatar.png",
  "name": "PostBridge AI",
  "trust": {
    "soc2": "pending",
    "audit": "Full cryptographic audit trail — each status change generates a signed VC",
    "proof": "Every letter receives a signed PostalProof Verifiable Credential (JWT)",
    "verify": "Any party can verify VCs independently using PostBridge's public key",
    "identity": "did:web:postbridge.ai",
    "data_scope": "PostBridge handles mailing data only to quote, print, send, track, and prove delivery of letters",
    "privacy_policy": "https://postbridge.ai/privacy.html",
    "retention_policy": "Recipient, sender, payment, delivery, and proof metadata may be retained as needed for fulfillment, tracking, receipts, fraud prevention, support, and legal/accounting obligations",
    "document_handling": "Uploaded PDFs are staged through single-use document URLs for order creation",
    "data_rights_contact": "agent@postbridge.ai"
  },
  "$schema": "https://postbridge.ai/schemas/agent-v1.json",
  "contact": "agent@postbridge.ai",
  "payment": {
    "methods": [
      {
        "type": "x402",
        "chain": "Base L2",
        "token": "USDC",
        "signup": false,
        "commission": "2.5%"
      },
      {
        "type": "usdc",
        "chain": "Base/Ethereum",
        "token": "USDC",
        "signup": true,
        "commission": "2.5%"
      },
      {
        "type": "btc_lightning",
        "chain": "Lightning",
        "token": "BTC",
        "signup": true,
        "commission": "2.5%"
      },
      {
        "type": "fiat_stripe",
        "signup": true,
        "commission": "5%",
        "currencies": [
          "USD",
          "EUR",
          "CAD"
        ]
      },
      {
        "type": "olas_mech",
        "chain": "Gnosis",
        "token": "xDAI",
        "description": "Per-action Mech pricing for on-chain agents"
      }
    ],
    "settlement": "Multi-currency (USD/EUR/GBP/CAD via Wise)",
    "pricing_model": {
      "note": "Prices vary by intent class — use /api/anp/offer to get a real-time quote",
      "formula": "postal_rate + print_cost + intent_pricing + commission",
      "crypto_advantage": {
        "note": "Crypto payers get the best available pricing",
        "commission": "2.5% (vs 5% fiat)",
        "additional_discount": true
      },
      "volume_discounts": {
        "note": "Commitment contracts unlock volume discounts",
        "available": true,
        "minimum_units": 51
      }
    }
  },
  "version": "0.3.0",
  "protocols": {
    "anp": {
      "spec": "ANP v0.2 (Agent Negotiation Protocol)",
      "endpoint": "https://api.postbridge.ai/api/anp/offer",
      "spec_url": "https://datatracker.ietf.org/doc/draft-ashraf-anp/",
      "description": "Agent Negotiation Protocol — intent-driven pricing with tiered offers"
    },
    "mcp": {
      "tools": 8,
      "endpoint": "https://api.postbridge.ai/mcp",
      "transport": "http+json-rpc",
      "description": "Model Context Protocol — 8 core tools for AI assistants (Claude, GPT, Eliza, etc.). The MCP server exposes the letter-sending workflow; account / settings / treasury surfaces are REST-only."
    },
    "rest": {
      "endpoint": "https://api.postbridge.ai",
      "description": "REST API for AI agents and developers",
      "developer_reference": "https://postbridge.ai/developers.html"
    },
    "erc8004": {
      "network": "Base L2",
      "description": "On-chain agent registry — discoverable by any ERC-8004 compatible framework"
    },
    "olas_mech": {
      "owner": "0xCD012Cd3413E8288e0FB330Fa37ac5d18a330c8b",
      "network": "ethereum",
      "pricing": {
        "send": {
          "wei": "20000000000000000",
          "human": "0.0200 xDAI"
        },
        "track": {
          "wei": "5000000000000000",
          "human": "0.0050 xDAI"
        },
        "negotiate": {
          "wei": "0",
          "human": "0.0000 xDAI",
          "description": "Free price discovery"
        }
      },
      "endpoint": "https://api.postbridge.ai/api/mech/execute",
      "code_ipfs": "ipfs://bafybeicocw2ynv7qtjlruryw5f45uey2c66w7e77mrnmkldlbcgkhppppm",
      "tool_name": "postbridge_send_letter",
      "description": "Callable on-chain as an Olas Mech tool — any Olas agent can discover and use PostBridge for physical mail",
      "marketplace": "https://marketplace.olas.network",
      "agent_nft_id": 58,
      "info_endpoint": "https://api.postbridge.ai/api/mech/info",
      "payment_token": "xDAI",
      "pricing_model": "per_action",
      "tools_endpoint": "https://api.postbridge.ai/api/mech/tools",
      "health_endpoint": "https://api.postbridge.ai/api/mech/health",
      "payment_network": "gnosis",
      "component_nft_id": 328
    },
    "fetchai_agentverse": {
      "protocol": "ASI Chat Protocol v0.3.0",
      "description": "Discoverable via Fetch.ai Almanac. Any ASI-compatible agent can send letters via natural-language chat.",
      "marketplace": "https://agentverse.ai",
      "agent_address": "agent1qd5emf3s5ts5mwssehczdlw0wsw556n9xahrgl5rzc3ury9u4as06z4dq32",
      "almanac_registry": "https://almanac.fetch.ai"
    }
  },
  "guarantees": {
    "digital_proof": "Certified/registered mail proof of delivery is always digital (webhook/API/email) — never physical for international",
    "recipient_routing": "Postal service is always determined by the recipient's country, never the sender's",
    "continuous_learning": "Every error is captured with full context and feeds back into improved validation, parsing, and response quality",
    "deterministic_pricing": "All prices come from rate tables — never estimated, rounded, or LLM-generated",
    "deterministic_addresses": "All addresses are validated and formatted by country-specific postal rules — never LLM-composed"
  },
  "description": "AI postal agent — send physical letters to US, France, UK, Canada, Germany. Intent-driven pricing via ANP (Agent Negotiation Protocol). Cryptographic proof of delivery via Verifiable Credentials. Zero-signup crypto payments via x402. Discoverable on the Olas Mech Marketplace (Agent NFT #58, Component NFT #328, Ethereum) and Fetch.ai Agentverse.",
  "capabilities": [
    {
      "name": "send_physical_letter",
      "input": "text, HTML, or PDF",
      "output": "letter_id, tracking_number, PostalProof VC (signed JWT)",
      "services": {
        "CA": [
          "ca_lettermail",
          "ca_registered",
          "ca_priority"
        ],
        "DE": [
          "de_standardbrief",
          "de_einschreiben",
          "de_einschreiben_einwurf"
        ],
        "FR": [
          "fr_lettre_verte",
          "fr_lettre_suivie",
          "fr_lettre_recommandee"
        ],
        "GB": [
          "gb_first_class",
          "gb_second_class",
          "gb_signed_for",
          "gb_special_delivery"
        ],
        "US": [
          "us_first_class",
          "us_certified",
          "us_priority"
        ]
      },
      "countries": [
        "US",
        "FR",
        "GB",
        "CA",
        "DE"
      ],
      "description": "Print, envelope, and mail a physical letter to any address in 5 countries"
    },
    {
      "name": "negotiate_pricing",
      "endpoint": "/api/anp/offer",
      "protocol": "ANP (draft-ashraf-anp-02)",
      "description": "Intent-driven tiered pricing. Request an offer, compare premium/standard/economy tiers with fiat and crypto prices, accept a tier, optionally commit volume for discounts.",
      "intent_classes": [
        "legal_compliance",
        "regulatory_filing",
        "transactional",
        "bulk_marketing",
        "confidential",
        "time_critical"
      ]
    },
    {
      "name": "track_delivery",
      "endpoint": "/api/track/{letter_id}",
      "description": "Real-time delivery tracking for any letter"
    },
    {
      "name": "proof_of_delivery",
      "endpoint": "/api/proof/{letter_id}",
      "description": "Cryptographic proof of sending and delivery — W3C Verifiable Credential (signed JWT)"
    },
    {
      "name": "letter_preview",
      "endpoint": "/orders/{order_id}/preview",
      "fidelity": "approximate (5-10mm variance in window/indicia placement; exact addresses and content)",
      "description": "Approximate visual preview of the printed letter (envelope outside + canonical inside) — generated at order creation. Returned as preview_url + preview_thumbnail_url in the createOrder + getOrder responses. Retained 90 days post-delivery.",
      "thumbnail_endpoint": "/orders/{order_id}/preview/thumbnail.png"
    },
    {
      "name": "identity_and_credentials",
      "features": [
        "DID resolution (did:key, did:pkh, did:web)",
        "UCAN capability delegation (escalation-proof)",
        "PostalProof VC, DeliveryProof VC, PaymentReceipt VC",
        "Cryptographic audit trail (each status change is a signed VC)"
      ],
      "standards": [
        "W3C DID",
        "UCAN 0.10.0",
        "W3C Verifiable Credentials"
      ]
    }
  ],
  "did_document": "https://postbridge.ai/.well-known/did.json",
  "tool_catalog": "https://postbridge.ai/mcp-tools.json",
  "authentication": {
    "methods": [
      {
        "type": "x402",
        "header": "X-PAYMENT-SIGNATURE",
        "description": "Pay per request with USDC on Base L2. Zero signup, no API key.",
        "signup_required": false
      },
      {
        "type": "ucan",
        "header": "Authorization: Bearer ucan:eyJ...",
        "description": "W3C DID-based capability tokens with delegation chains.",
        "signup_required": false
      },
      {
        "type": "api_key",
        "header": "Authorization: Bearer pb_live_...",
        "description": "Traditional API key authentication.",
        "signup_required": true
      }
    ],
    "preferred": "x402"
  },
  "agent_quickstart": "https://postbridge.ai/agent-quickstart.md"
}