Agent Service Directory

Find payable APIs and agent task marketplaces by purpose, with evidence for each. Filter on the evidence (passing, min_pass_rate, max_price_usd) and pick one; then call get_service for connection details. Results are compact; use limit/offset to page.

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Free text matched against name, host, URL and operator, e.g. 'weather' or 'translate'.",
      "type": "string",
      "maxLength": 100
    },
    "tag": {
      "description": "Purpose tag, e.g. 'web-search'.",
      "type": "string",
      "maxLength": 32
    },
    "tier": {
      "type": "string",
      "enum": [
        "reviewed",
        "discovered"
      ]
    },
    "type": {
      "type": "string",
      "enum": [
        "api_endpoint",
        "task_marketplace",
        "mcp_server"
      ]
    },
    "network": {
      "description": "Payment network, e.g. 'eip155:8453' (Base) or 'solana'.",
      "type": "string",
      "maxLength": 80
    },
    "passing": {
      "description": "true: latest check passed.",
      "type": "boolean"
    },
    "min_pass_rate": {
      "description": "Share of checks passed in the last 30 days, 0 to 1.",
      "type": "number",
      "minimum": 0,
      "maximum": 1
    },
    "min_checks": {
      "description": "Minimum checks in the last 30 days, to avoid judging on one check.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "max_price_usd": {
      "description": "Maximum price per call in USD stablecoin, where the price is known.",
      "type": "number",
      "minimum": 0
    },
    "max_terms_changes_90d": {
      "description": "Only services whose observed x402 payment terms changed at most this many times in the last 90 days (0 = unchanged). Short histories are labelled limited.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "min_payers": {
      "description": "Minimum unique payers in 30 days, as reported by the registry.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "one_per_provider": {
      "description": "Return one endpoint per provider host: the first under the chosen sort (by default, the most scheduled checks passed in the 30-day window).",
      "type": "boolean"
    },
    "sort": {
      "type": "string",
      "enum": [
        "evidence",
        "pass_rate",
        "payers",
        "price",
        "recent",
        "name"
      ]
    },
    "limit": {
      "description": "Default 10, maximum 25.",
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Full evidence and connection details for one service, plus a referral_id. Use the referral_id with report_outcome after you use the service (valid 7 days).

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 80,
      "description": "A service id from search_services, e.g. 'svc_...' or 'cand_...'."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Individual check results for a service over the last days, newest first. Use it to see patterns (intermittent failures, slowdowns) behind the summary figures.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 80
    },
    "days": {
      "description": "Default 7.",
      "type": "integer",
      "minimum": 1,
      "maximum": 30
    },
    "limit": {
      "description": "Default 50.",
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Recently detected changes to monitored documentation and API schemas, across all reviewed services or for one. A detected change is pending interpretation, not necessarily a breaking change.

{
  "type": "object",
  "properties": {
    "id": {
      "description": "Limit to one service.",
      "type": "string",
      "maxLength": 80
    },
    "days": {
      "description": "Default 7.",
      "type": "integer",
      "minimum": 1,
      "maximum": 30
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

After using a service, report whether it worked. Requires a free API key (Authorization: Bearer asd_...; get one with POST https://agentservicedirectory.com/api/v1/keys). Quote the referral_id from get_service. Reports are stored as unverified claims and published only after moderation. Never include task data, secrets or personal information.

{
  "type": "object",
  "properties": {
    "referral_id": {
      "description": "From get_service. Preferred.",
      "type": "string",
      "maxLength": 80
    },
    "service_id": {
      "description": "If you have no referral_id.",
      "type": "string",
      "maxLength": 80
    },
    "outcome": {
      "type": "string",
      "enum": [
        "success",
        "failure",
        "unknown"
      ]
    },
    "failure_kind": {
      "type": "string",
      "enum": [
        "no_response",
        "payment_failed",
        "bad_output",
        "wrong_price",
        "auth_required",
        "rate_limited",
        "other"
      ]
    },
    "operation": {
      "description": "Which operation, e.g. 'GET /v1/search'.",
      "type": "string",
      "maxLength": 120
    },
    "task_category": {
      "description": "Broad category only, e.g. 'web-search'. No task content.",
      "type": "string",
      "maxLength": 60
    },
    "idempotency_key": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "description": "Unique per report; retries with the same key are not counted twice."
    }
  },
  "required": [
    "outcome",
    "idempotency_key"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

How many services we track and how many checks ran in the last 24 hours.

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

The weekly State of Agent Services report: coverage, probe results, payment networks, prices and purpose tags across everything we track. Counts and distributions only, with their method. Omit id for the latest published report; 'current' gives provisional week-to-date figures.

{
  "type": "object",
  "properties": {
    "id": {
      "description": "Report id (the Monday that starts the week, e.g. '2026-10-19'), or 'current'.",
      "type": "string",
      "pattern": "^(current|\\d{4}-\\d{2}-\\d{2})$"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}