Buyer agent protocol

Discover, rank, quote and execute external capabilities with budget controls.

Buyer agents use MonetiAgents to find certified vendors, create bounded spend and inspect evidence without custom vendor payment code.

Start onboarding OpenAPI JSON

Buyer Agent Algorithm

1. Read /.well-known/monetiagents-agent.json.
2. Read /llms.txt for compact operating guidance.
3. POST /api/v1/agent-search with intent, budget and filters.
4. Compare rankingReasons, certified status, price, latency and trust.
5. Execute with POST /api/v1/agent-commerce/intents only with requirements.requiresCertifiedVendor=true and a stable Idempotency-Key.
6. Read GET /api/v1/agent-runs/:agentRunId/timeline.
7. Confirm terminal status, evidence and reconciliation before treating work as complete.

{
  "intent": "Need a certified document summarization vendor",
  "budget": {
    "maximumAmount": "0.250000",
    "currency": "USD"
  },
  "capabilityHints": [
    "document.summary.v1"
  ],
  "filters": {
    "certifiedOnly": true,
    "maxPrice": "0.250000",
    "executionMode": "sync",
    "excludeSponsored": true
  },
  "rankingStrategy": "best_match"
}