Bearer key · query string
GET /api/v1/directory/search
curl -s "https://getattest.com.au/api/v1/directory/search?q=mcp&limit=2" \
-H "authorization: Bearer $ATTEST_API_KEY"
Send the key as a bearer token in the authorization header. One key and one credit balance cover every service, including Attest Capture. A failed call is refunded automatically. No key yet? POST /api/v1/keys issues one with 25 free credits and no signup — see the key guide.
Captured 2026-09-21
Example
This request was run against the running service on 2026-09-21 and the response below is what came back, unedited.
Request JSON
{
"q": "mcp",
"limit": 2
}
Captured response JSON
{
"call_id": "d4e68bfe-1ccb-4434-bcac-6a6f171fe2fd",
"query": {
"q": "mcp",
"category": null,
"limit": 2
},
"count": 2,
"tools": [
{
"name": "Pipedream",
"slug": "pipedream",
"tagline": "Integration platform with MCP servers exposing 10,000+ tools to agents",
"category": "workflow-orchestration",
"pricing_model": "freemium",
"url": "https://pipedream.com/",
"attest_url": "https://getattest.com.au/t/pipedream",
"github": null,
"verified_at": "2026-08-25T02:49:18.002Z",
"featured": false,
"paid_placement": false
},
{
"name": "Nango",
"slug": "nango",
"tagline": "Open-source platform for product integrations with 900+ APIs",
"category": "apis-for-agents",
"pricing_model": "open-source",
"url": "https://www.nango.dev/",
"attest_url": "https://getattest.com.au/t/nango",
"github": "https://github.com/NangoHQ/nango",
"verified_at": "2026-08-25T02:49:16.237Z",
"featured": false,
"paid_placement": false
}
],
"ranking": "Tools with featured: true (paid_placement: true) are paid Featured Launch placements and are listed first. A tool must pass the same verification as a free listing before it can be featured. All other tools are listed newest launch first.",
"verification_scope": "Availability, public product evidence and supplied-link checks. Not an endorsement or security audit.",
"checked_at": "2026-09-20T16:55:56.824Z",
"credits_charged": 0,
"credits_remaining": 9996
}
For agents
Use when
Use this when an agent needs to find AI-agent tools (MCP servers, frameworks, browser automation, memory, evals, voice, coding agents and more) by keyword or category before choosing one.
3 fields
Input
Scroll the table horizontally to see all fields.
Field / Type / Required / What it does| Field | Type | Required | What it does |
|---|
q | string | Optional | Keyword to search over the verified tool listings. |
|---|
category | string | Optional | One of the Attest directory category slugs. |
|---|
limit | integer | Optional | Maximum tools to return. |
|---|
HTTP 200
Response
Every successful response also carries call_id (your receipt for the charge), credits_charged and credits_remaining.
Scroll the table horizontally to see all fields.
Field / What it holds| Field | What it holds |
|---|
query | The query as it was read. |
|---|
count | Tools returned. |
|---|
tools | Each tool: name, slug, tagline, category, pricing model, its own URL, its Attest page, GitHub, verified_at, and whether it holds a paid placement. |
|---|
ranking | How the results were ordered. |
|---|
verification_scope | Exactly what Attested means, and what it does not claim. |
|---|
Machine-readable failures
Errors
Errors return JSON such as {"error":"invalid_api_key"}. A failed call is refunded automatically.
Scroll the table horizontally to see all fields.
Code / Status / Meaning| Code | Status | Meaning |
|---|
invalid_category | 400 | category is not an Attest directory category. |
|---|
invalid_limit | 400 | limit is not a whole number in range. |
|---|
services_unavailable | 503 | The directory store could not be read. |
|---|
On every service
Scroll the table horizontally to see all fields.
Code / Status / Meaning| Code | Status | Meaning |
|---|
invalid_api_key | 401 | The authorization header is missing or the key is unknown. |
|---|
insufficient_credits | 402 | The balance is below this call's cost. The response carries credits_required and credits_remaining. |
|---|
rate_limit_exceeded | 429 | Free keys share 10 calls a minute across every service. The response carries limit and window_seconds. |
|---|
services_unavailable | 503 | The credit store could not be reached. Retry once after 30 seconds. |
|---|
Where the answer comes from
Source and scope
Listings come from the Attest verified directory. A tool holding a paid featured placement is flagged as paid_placement on the row itself.
Attest reports what it read, with the source it read it from. It is general information, not advice, and not a legal record.
All Attest tools · Service list as JSON · OpenAPI