AnyAPI
Hundreds of scraping & data APIs through one key. USD pay-per-request, normalized schemas, failover.
¿Debería usar esto?
Calidad y seguridad
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"anyapi": {
"command": "npx",
"args": [
"anyapi-mcp"
]
}
}
}Paquetes ejecutables
0.1.5stdioPuntos de conexión remotos
https://api.getanyapi.com/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (10)
🟢get_api(context, sku_id)
Get the full definition of one API by API slug, including its normalized input/output JSON schemas, per-request and per-1,000-request USD pricing on every source, and nullable trailing-30-day latency p50/p95/p99 with the successful sample count. Latency percentiles describe observed successful requests; p99 is an observation, not a maximum or a client timeout guarantee. Entries with heavy:true produce large API responses.
Esquema de entrada
{
"type": "object",
"properties": {
"context": {
"description": "Brief purpose of this tool call within the requested task, used for analytics and user-intent tracking.",
"type": "string"
},
"sku_id": {
"description": "the API SKU slug to describe",
"type": "string"
}
},
"required": [
"sku_id",
"context"
]
}Esquema de salida
{
"type": "object",
"properties": {
"scraper": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"slug": {
"type": "string"
},
"category": {
"type": "string"
},
"name": {
"type": "string"
},
"method": {
"type": "string"
},
"path": {
"type": "string"
},
"provider": {
"type": "string"
},
"execution": {
"type": "object",
"properties": {
"mode": {
"type": "string"
}
},
"required": [
"mode"
],
"additionalProperties": false
},
"pricing": {
"type": "object",
"properties": {
"from": {
"type": "object",
"properties": {
"model": {
"type": "string"
},
"unit": {
"type": "string"
},
"baseUsd": {
"type": [
"null",
"number"
]
},
"perUnitUsd": {
"type": [
"null",
"number"
]
},
"maxUsd": {
"type": "number"
},
"maxPer1kUsd": {
"type": "number"
},
"addons": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"label": {
"type": "string"
},
"field": {
"type": "string"
},
"usd": {
"type": "number"
}
},
"required": [
"id",
"label",
"field",
"usd"
],
"additionalProperties": false
}
}
},
"required": [
"model",
"unit",
"maxUsd",
"maxPer1kUsd"
],
"additionalProperties": false
},
"failoverMaxUsd": {
"type": "number"
},
"failoverMaxPer1kUsd": {
"type": "number"
}
},
"required": [
"from",
"failoverMaxUsd",
"failoverMaxPer1kUsd"
],
"additionalProperties": false
},
"heavy": {
"type": "boolean"
},
"failover": {
"type": "boolean"
},
"excludesCallerDelay": {
"type": "boolean"
},
"description": {
"type": "string"
},
"lanes": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"properties": {
"pricing": {
"type": "object",
"properties": {
"model": {
"type": "string"
},
"unit": {
"type": "string"
},
"baseUsd": {
"type": [
"null",
"number"
]
},
"perUnitUsd": {
"type": [
"null",
"number"
]
},
"maxUsd": {
"type": "number"
},
"maxPer1kUsd": {
"type": "number"
},
"addons": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"label": {
"type": "string"
},
"field": {
"type": "string"
},
"usd": {
"type": "number"
}
},
"required": [
"id",
"label",
"field",
"usd"
],
"additionalProperties": false
}
}
},
"required": [
"model",
"unit",
"maxUsd",
"maxPer1kUsd"
],
"additionalProperties": false
},
"source": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"kind": {
"type": "string"
},
"artworkKey": {
"type": "string"
}
},
"required": [
"id",
"name",
"kind",
"artworkKey"
],
"additionalProperties": false
},
"health": {
"type": [
"null",
"object"
],
"properties": {
"window": {
"type": "string"
},
"uptimePct": {
"type": "number"
},
"latencyP50Ms": {
"type": "integer"
},
"uptimeSample": {
"type": "integer"
},
"latencySample": {
"type": "integer"
},
"requests": {
"type": "integer"
},
"servedRequests": {
"type": "integer"
},
"blockedPct": {
"type": [
"null",
"number"
]
}
},
"required": [
"window",
"uptimePct",
"latencyP50Ms",
"uptimeSample",
"latencySample",
"requests",
"servedRequests"
],
"additionalProperties": false
},
"fields": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
}
},
"required": [
"pricing",
"source"
],
"additionalProperties": false
}
},
"latency": {
"type": [
"null",
"object"
],
"properties": {
"window": {
"type": "string"
},
"p50Ms": {
"type": "integer"
},
"p95Ms": {
"type": "integer"
},
"p99Ms": {
"type": "integer"
},
"sample": {
"type": "integer"
},
"basis": {
"type": "string"
}
},
"required": [
"window",
"p50Ms",
"p95Ms",
"p99Ms",
"sample",
"basis"
],
"additionalProperties": false
},
"inputSchema": true,
"outputSchema": true,
"tryEligible": {
"type": "boolean"
},
"tryMaxItems": {
"type": [
"null",
"integer"
]
}
},
"description": "the API definition with input/output schemas",
"required": [
"id",
"slug",
"category",
"name",
"method",
"path",
"provider",
"execution",
"pricing",
"failover",
"description",
"lanes",
"latency",
"tryEligible"
],
"additionalProperties": false
}
},
"required": [
"scraper"
],
"additionalProperties": false
}🟢get_balance(context)
Get the remaining wallet balance (in USD) for the AnyAPI key supplied as a Bearer token. Requires a valid AnyAPI key.
Esquema de entrada
{
"type": "object",
"properties": {
"context": {
"description": "Brief purpose of this tool call within the requested task, used for analytics and user-intent tracking.",
"type": "string"
}
},
"required": [
"context"
]
}Esquema de salida
{
"type": "object",
"properties": {
"balanceUsd": {
"type": "number",
"description": "remaining wallet balance for this API key, in USD"
}
},
"required": [
"balanceUsd"
],
"additionalProperties": false
}🟢get_request(context, request_id)
Inspect or resume a durable AnyAPI request by request_id. This reads AnyAPI's stored state and never repeats the paid provider dispatch. While status is queued or running, retryAfterSeconds gives the minimum interval between status checks.
Esquema de entrada
{
"type": "object",
"properties": {
"context": {
"description": "Brief purpose of this tool call within the requested task, used for analytics and user-intent tracking.",
"type": "string"
},
"request_id": {
"description": "durable request identifier returned by run_api",
"type": "string"
}
},
"required": [
"request_id",
"context"
]
}Esquema de salida
{
"type": "object",
"properties": {
"output": {
"description": "normalized output payload"
},
"provider": {
"type": "string",
"description": "the provider serving the request (AnyAPI)"
},
"costUsd": {
"type": "number",
"description": "amount charged to the wallet in USD"
},
"items": {
"type": "integer",
"description": "number of result rows returned; an API that returns one record counts it as one row. For per-result APIs the per-item cost is charged against this; for input-priced APIs (perItemUnit != result) the charge is per submitted input, independent of this count"
},
"source": {
"type": [
"null",
"object"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"kind": {
"type": "string"
},
"artworkKey": {
"type": "string"
}
},
"description": "the source that served this request; its id is accepted by 'source' for preference or 'ignoreSources' for exclusion. Absent when no source identity applies",
"required": [
"id",
"name",
"kind",
"artworkKey"
],
"additionalProperties": false
},
"replayed": {
"type": "boolean",
"description": "true when this response replays an identical earlier call (same API, same input) from the last few minutes instead of running again: nothing new was executed and costUsd restates the original charge, it was NOT charged a second time"
},
"hint": {
"type": "string",
"description": "optional result caveat. 'large_result:' identifies a large response; fields/max_items/summary reduce response size without changing cost. 'paging_unavailable:' means the source cannot return a nextCursor, so the result may be incomplete and cannot be paged further; requireFields [\"nextCursor\"] restricts execution to sources that support pagination and may cost more per request. 'malformed_query:' means X interpreted adjacent bare words as ANDed and OR as having higher precedence, so a multi-word alternative is not a phrase; the result reflects that interpretation, and the hint includes a corrected query. 'date_adjusted:' means an input date was outside the platform's accepted range, so execution used the nearest accepted date named in the hint"
},
"resultId": {
"type": "string",
"description": "opaque handle to the full result, cached ~15 min; identifies the paid result available for free reshaping without another execution or charge. Absent when the result was too large to cache"
},
"jqError": {
"type": "string",
"description": "present only when a jq expression failed; output then holds the full unshaped result and this explains why the reshape did not apply"
},
"requestId": {
"type": "string",
"description": "durable request identifier for stored status and result retrieval without repeating the paid provider dispatch"
},
"status": {
"type": "string",
"description": "durable request status: queued, running, succeeded, failed, or expired"
},
"serviceOutcome": {
"type": "string",
"description": "end-to-end AnyAPI service outcome when known"
},
"settlementState": {
"type": "string",
"description": "payment settlement state when known; independent of durable request status"
},
"error": {
"type": [
"null",
"object"
],
"properties": {
"code": {
"type": "string",
"description": "safe AnyAPI error code"
}
},
"description": "safe AnyAPI failure code when durable work failed",
"required": [
"code"
],
"additionalProperties": false
},
"nextAction": {
"type": [
"null",
"object"
],
"properties": {
"tool": {
"type": "string",
"description": "MCP tool name for stored-request retrieval"
},
"requestId": {
"type": "string",
"description": "durable request identifier for stored-request retrieval"
},
"retryAfterSeconds": {
"type": "integer",
"description": "minimum delay before polling again"
}
},
"description": "stored-request retrieval coordinates and polling interval present while durable work is pending",
"required": [
"tool",
"requestId",
"retryAfterSeconds"
],
"additionalProperties": false
}
},
"required": [
"output",
"provider",
"costUsd",
"items",
"replayed"
],
"additionalProperties": false
}🟢list_apis(category, context)
Browse available AnyAPI APIs as lightweight summaries (id, name, category, USD pricing), optionally filtered by category. Descriptions and schemas are omitted to keep catalog responses small. Each pricing offer carries both `maxUsd` (billed per request) and `maxPer1kUsd` (the same price per 1,000 requests).
Esquema de entrada
{
"type": "object",
"properties": {
"category": {
"description": "optional category slug to filter by",
"type": "string"
},
"context": {
"description": "Brief purpose of this tool call within the requested task, used for analytics and user-intent tracking.",
"type": "string"
}
},
"required": [
"context"
]
}Esquema de salida
{
"type": "object",
"properties": {
"scrapers": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"slug": {
"type": "string"
},
"category": {
"type": "string"
},
"name": {
"type": "string"
},
"method": {
"type": "string"
},
"path": {
"type": "string"
},
"provider": {
"type": "string"
},
"execution": {
"type": "object",
"properties": {
"mode": {
"type": "string"
}
},
"required": [
"mode"
],
"additionalProperties": false
},
"pricing": {
"type": "object",
"properties": {
"from": {
"type": "object",
"properties": {
"model": {
"type": "string"
},
"unit": {
"type": "string"
},
"baseUsd": {
"type": [
"null",
"number"
]
},
"perUnitUsd": {
"type": [
"null",
"number"
]
},
"maxUsd": {
"type": "number"
},
"maxPer1kUsd": {
"type": "number"
},
"addons": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"label": {
"type": "string"
},
"field": {
"type": "string"
},
"usd": {
"type": "number"
}
},
"required": [
"id",
"label",
"field",
"usd"
],
"additionalProperties": false
}
}
},
"required": [
"model",
"unit",
"maxUsd",
"maxPer1kUsd"
],
"additionalProperties": false
},
"failoverMaxUsd": {
"type": "number"
},
"failoverMaxPer1kUsd": {
"type": "number"
}
},
"required": [
"from",
"failoverMaxUsd",
"failoverMaxPer1kUsd"
],
"additionalProperties": false
},
"heavy": {
"type": "boolean"
},
"failover": {
"type": "boolean"
},
"excludesCallerDelay": {
"type": "boolean"
}
},
"required": [
"id",
"slug",
"category",
"name",
"method",
"path",
"provider",
"execution",
"pricing",
"failover"
],
"additionalProperties": false
},
"description": "matching APIs (lightweight summaries: no description or schemas)"
}
},
"required": [
"scrapers"
],
"additionalProperties": false
}🟢quote_api(context, input, sku_id)
Get the exact input-aware execution price for an API, free and without a key. Nothing is charged or executed. `sku_id` and `input` identify the proposed execution; pricing resolves exactly as it does for execution, and input validation can return invalid_input without a charge. Returns maxCostUsd (the ceiling reserved), minCostUsd (the likely charge), and the base/per-item breakdown explaining why they differ. These are USD amounts for this one call, not per-1,000-request catalog comparison rates.
Esquema de entrada
{
"type": "object",
"properties": {
"context": {
"description": "Brief purpose of this tool call within the requested task, used for analytics and user-intent tracking.",
"type": "string"
},
"input": {
"additionalProperties": true,
"description": "the exact normalized input payload being priced; the quote resolves pricing the same way execution does",
"type": "object"
},
"sku_id": {
"description": "the API SKU slug to price",
"type": "string"
}
},
"required": [
"sku_id",
"input",
"context"
]
}Esquema de salida
{
"type": "object",
"properties": {
"maxCostUsd": {
"type": "number",
"description": "the most this call can charge - the reserve held before running"
},
"minCostUsd": {
"type": "number",
"description": "the likely charge - the cheapest route serves first"
},
"baseUsd": {
"type": "number",
"description": "fixed cost per call in USD, charged regardless of count"
},
"perItemUsd": {
"type": "number",
"description": "marginal cost in USD per billable unit (see perItemUnit); 0 for a flat SKU"
},
"perItemUnit": {
"type": "string",
"description": "the unit perItemUsd is charged per: 'result' (default) or an input unit like 'username' for input-priced SKUs"
},
"exact": {
"type": "boolean",
"description": "true when the price is exact (minCostUsd == maxCostUsd): a flat SKU or a sealed page"
},
"pricing": {
"type": "string",
"description": "a one-line human explanation of how this call is priced"
}
},
"required": [
"maxCostUsd",
"minCostUsd",
"baseUsd",
"perItemUsd",
"exact",
"pricing"
],
"additionalProperties": false
}🟢read_result(context, fields, jq, max_items, result_id, ...)
Read or reshape a previously paid API result without executing or paying again. `result_id` identifies the full cached result; fields/max_items/summary/jq control its presentation, including row selection and slicing large fields. Results are cached ~15 min and are private to the authenticated account; an expired id returns result_expired.
Esquema de entrada
{
"type": "object",
"properties": {
"context": {
"description": "Brief purpose of this tool call within the requested task, used for analytics and user-intent tracking.",
"type": "string"
},
"fields": {
"description": "optional: keep only these keys on each result item - each row of the result list, or the data object itself for an API that returns one record (dotted paths like 'author.name' descend into nested objects)",
"items": {
"type": "string"
},
"type": [
"null",
"array"
]
},
"jq": {
"description": "optional: a jq expression to reshape the result; its output replaces 'output'. Example: '.data | {title, description, md: .markdown[:3500]}'. Sandboxed 250ms/2MB budget",
"type": "string"
},
"max_items": {
"description": "optional: cap the number of result items returned; a _truncated note reports how many were withheld. An API that returns one record is not trimmed",
"type": [
"null",
"integer"
]
},
"result_id": {
"description": "the resultId returned by a prior run_api call (cached ~15 min)",
"type": "string"
},
"summary": {
"description": "optional: return only a structural outline (top-level keys, item counts, per-field byte sizes) instead of the full data",
"type": "boolean"
}
},
"required": [
"result_id",
"context"
]
}Esquema de salida
{
"type": "object",
"properties": {
"output": {
"description": "normalized output payload"
},
"provider": {
"type": "string",
"description": "the provider serving the request (AnyAPI)"
},
"costUsd": {
"type": "number",
"description": "amount charged to the wallet in USD"
},
"items": {
"type": "integer",
"description": "number of result rows returned; an API that returns one record counts it as one row. For per-result APIs the per-item cost is charged against this; for input-priced APIs (perItemUnit != result) the charge is per submitted input, independent of this count"
},
"source": {
"type": [
"null",
"object"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"kind": {
"type": "string"
},
"artworkKey": {
"type": "string"
}
},
"description": "the source that served this request; its id is accepted by 'source' for preference or 'ignoreSources' for exclusion. Absent when no source identity applies",
"required": [
"id",
"name",
"kind",
"artworkKey"
],
"additionalProperties": false
},
"replayed": {
"type": "boolean",
"description": "true when this response replays an identical earlier call (same API, same input) from the last few minutes instead of running again: nothing new was executed and costUsd restates the original charge, it was NOT charged a second time"
},
"hint": {
"type": "string",
"description": "optional result caveat. 'large_result:' identifies a large response; fields/max_items/summary reduce response size without changing cost. 'paging_unavailable:' means the source cannot return a nextCursor, so the result may be incomplete and cannot be paged further; requireFields [\"nextCursor\"] restricts execution to sources that support pagination and may cost more per request. 'malformed_query:' means X interpreted adjacent bare words as ANDed and OR as having higher precedence, so a multi-word alternative is not a phrase; the result reflects that interpretation, and the hint includes a corrected query. 'date_adjusted:' means an input date was outside the platform's accepted range, so execution used the nearest accepted date named in the hint"
},
"resultId": {
"type": "string",
"description": "opaque handle to the full result, cached ~15 min; identifies the paid result available for free reshaping without another execution or charge. Absent when the result was too large to cache"
},
"jqError": {
"type": "string",
"description": "present only when a jq expression failed; output then holds the full unshaped result and this explains why the reshape did not apply"
},
"requestId": {
"type": "string",
"description": "durable request identifier for stored status and result retrieval without repeating the paid provider dispatch"
},
"status": {
"type": "string",
"description": "durable request status: queued, running, succeeded, failed, or expired"
},
"serviceOutcome": {
"type": "string",
"description": "end-to-end AnyAPI service outcome when known"
},
"settlementState": {
"type": "string",
"description": "payment settlement state when known; independent of durable request status"
},
"error": {
"type": [
"null",
"object"
],
"properties": {
"code": {
"type": "string",
"description": "safe AnyAPI error code"
}
},
"description": "safe AnyAPI failure code when durable work failed",
"required": [
"code"
],
"additionalProperties": false
},
"nextAction": {
"type": [
"null",
"object"
],
"properties": {
"tool": {
"type": "string",
"description": "MCP tool name for stored-request retrieval"
},
"requestId": {
"type": "string",
"description": "durable request identifier for stored-request retrieval"
},
"retryAfterSeconds": {
"type": "integer",
"description": "minimum delay before polling again"
}
},
"description": "stored-request retrieval coordinates and polling interval present while durable work is pending",
"required": [
"tool",
"requestId",
"retryAfterSeconds"
],
"additionalProperties": false
}
},
"required": [
"output",
"provider",
"costUsd",
"items",
"replayed"
],
"additionalProperties": false
}🟡report_bug(contact, context, details, request_id, sku, ...)
Submit a defect report to AnyAPI about wrong, empty, or malformed API data for valid input, misleading or unactionable errors, incorrect prices or schemas, or retries that failed unexpectedly. Free, never charged. `summary` is required and contains one line; optional `request_id` identifies the stored request and its upstream error body without requiring the payload in the report.
Esquema de entrada
{
"type": "object",
"properties": {
"contact": {
"description": "optional: an email address for a reply; trial keys have no reachable account contact",
"type": "string"
},
"context": {
"description": "Brief purpose of this tool call within the requested task, used for analytics and user-intent tracking.",
"type": "string"
},
"details": {
"description": "optional: what you expected, what you got, and anything you already tried",
"type": "string"
},
"request_id": {
"description": "optional: the requestId or resultId from the run that went wrong. This is the single most useful field: it reaches the stored run, its attempts, and any upstream error body, so you do not need to paste the payload",
"type": "string"
},
"sku": {
"description": "optional: the sku_id this is about, e.g. 'instagram.reels_search'",
"type": "string"
},
"summary": {
"description": "one line saying what went wrong or what you want to tell us",
"type": "string"
}
},
"required": [
"summary",
"context"
]
}Esquema de salida
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "the stored report id for support correspondence"
},
"received": {
"type": "boolean",
"description": "true when the report is stored"
}
},
"required": [
"id",
"received"
],
"additionalProperties": false
}🔴run_api(context, fields, input, jq, max_items, ...)
Execute an API by API slug with a normalized input payload. Every input schema is strict: unknown fields are rejected, not ignored, and field names can differ between related APIs. Inputs must conform to the endpoint's schema, not its description. Published latency p50/p95/p99 and sample counts describe observed successful requests; p99 is an observation, not a maximum or a client timeout guarantee. Requires a valid AnyAPI key as a Bearer token. Charges the USD wallet. Some failed wallet-funded requests incur processing charges passed through at cost, with no markup; the error message shows the amount charged. Results can be large. `fields` keeps selected keys, `max_items` caps returned rows, and `summary` returns an outline; these controls reduce response size without changing the charge.
Esquema de entrada
{
"type": "object",
"properties": {
"context": {
"description": "Brief purpose of this tool call within the requested task, used for analytics and user-intent tracking.",
"type": "string"
},
"fields": {
"description": "optional: keep only these keys on each result item - each row of the result list, or the data object itself for an API that returns one record (dotted paths like 'author.name' descend into nested objects). Shrinks the response without changing cost",
"items": {
"type": "string"
},
"type": [
"null",
"array"
]
},
"input": {
"additionalProperties": true,
"description": "normalized input payload matching the API input schema",
"type": "object"
},
"jq": {
"description": "optional: a jq expression to reshape the result; its output replaces 'output' (multiple outputs collect into an array). Example: '.data | {title, description, md: .markdown[:3500]}'. Sandboxed 250ms/2MB budget; on failure the full result is returned with jqError. Does not change cost",
"type": "string"
},
"max_items": {
"description": "optional: cap the number of result items returned; a _truncated note reports how many were withheld. An API that returns one record is not trimmed. Does not change cost",
"type": [
"null",
"integer"
]
},
"sku_id": {
"description": "the API SKU slug to execute",
"type": "string"
},
"summary": {
"description": "optional: return only a structural outline (top-level keys, item counts, and per-field byte sizes) instead of the full data. Does not change cost",
"type": "boolean"
}
},
"required": [
"sku_id",
"input",
"context"
]
}Esquema de salida
{
"type": "object",
"properties": {
"output": {
"description": "normalized output payload"
},
"provider": {
"type": "string",
"description": "the provider serving the request (AnyAPI)"
},
"costUsd": {
"type": "number",
"description": "amount charged to the wallet in USD"
},
"items": {
"type": "integer",
"description": "number of result rows returned; an API that returns one record counts it as one row. For per-result APIs the per-item cost is charged against this; for input-priced APIs (perItemUnit != result) the charge is per submitted input, independent of this count"
},
"source": {
"type": [
"null",
"object"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"kind": {
"type": "string"
},
"artworkKey": {
"type": "string"
}
},
"description": "the source that served this request; its id is accepted by 'source' for preference or 'ignoreSources' for exclusion. Absent when no source identity applies",
"required": [
"id",
"name",
"kind",
"artworkKey"
],
"additionalProperties": false
},
"replayed": {
"type": "boolean",
"description": "true when this response replays an identical earlier call (same API, same input) from the last few minutes instead of running again: nothing new was executed and costUsd restates the original charge, it was NOT charged a second time"
},
"hint": {
"type": "string",
"description": "optional result caveat. 'large_result:' identifies a large response; fields/max_items/summary reduce response size without changing cost. 'paging_unavailable:' means the source cannot return a nextCursor, so the result may be incomplete and cannot be paged further; requireFields [\"nextCursor\"] restricts execution to sources that support pagination and may cost more per request. 'malformed_query:' means X interpreted adjacent bare words as ANDed and OR as having higher precedence, so a multi-word alternative is not a phrase; the result reflects that interpretation, and the hint includes a corrected query. 'date_adjusted:' means an input date was outside the platform's accepted range, so execution used the nearest accepted date named in the hint"
},
"resultId": {
"type": "string",
"description": "opaque handle to the full result, cached ~15 min; identifies the paid result available for free reshaping without another execution or charge. Absent when the result was too large to cache"
},
"jqError": {
"type": "string",
"description": "present only when a jq expression failed; output then holds the full unshaped result and this explains why the reshape did not apply"
},
"requestId": {
"type": "string",
"description": "durable request identifier for stored status and result retrieval without repeating the paid provider dispatch"
},
"status": {
"type": "string",
"description": "durable request status: queued, running, succeeded, failed, or expired"
},
"serviceOutcome": {
"type": "string",
"description": "end-to-end AnyAPI service outcome when known"
},
"settlementState": {
"type": "string",
"description": "payment settlement state when known; independent of durable request status"
},
"error": {
"type": [
"null",
"object"
],
"properties": {
"code": {
"type": "string",
"description": "safe AnyAPI error code"
}
},
"description": "safe AnyAPI failure code when durable work failed",
"required": [
"code"
],
"additionalProperties": false
},
"nextAction": {
"type": [
"null",
"object"
],
"properties": {
"tool": {
"type": "string",
"description": "MCP tool name for stored-request retrieval"
},
"requestId": {
"type": "string",
"description": "durable request identifier for stored-request retrieval"
},
"retryAfterSeconds": {
"type": "integer",
"description": "minimum delay before polling again"
}
},
"description": "stored-request retrieval coordinates and polling interval present while durable work is pending",
"required": [
"tool",
"requestId",
"retryAfterSeconds"
],
"additionalProperties": false
}
},
"required": [
"output",
"provider",
"costUsd",
"items",
"replayed"
],
"additionalProperties": false
}🟢search_apis(category, context, limit, platform, query)
Search APIs by meaning and keyword across name, slug, and description, returning matches with their descriptions but without schemas, ranked most relevant first. At least one of `query`, `category`, or `platform` is required, in any combination; `category` or `platform` without `query` enumerates that scope. `limit` caps matches (default 25, maximum 50). Each result carries a `relevance` score in (0,1] relative to the top match; a relevance floor drops weak matches, so `total` counts relevant matches before the limit. `ranking` identifies meaning-based ('semantic') or substring ('keyword') matching. Entries with heavy:true produce large API responses. Search results omit input schemas; API inputs require the endpoint's strict schema, whose field names can differ between related APIs.
Esquema de entrada
{
"type": "object",
"properties": {
"category": {
"description": "optional category slug to narrow the search",
"type": "string"
},
"context": {
"description": "Brief purpose of this tool call within the requested task, used for analytics and user-intent tracking.",
"type": "string"
},
"limit": {
"description": "optional cap on matches returned (default 25, maximum 50)",
"type": [
"null",
"integer"
]
},
"platform": {
"description": "optional API slug prefix to narrow the search",
"type": "string"
},
"query": {
"description": "free-text search over API name, slug, and description; optional when category or platform is given",
"type": "string"
}
},
"required": [
"context"
]
}Esquema de salida
{
"type": "object",
"properties": {
"results": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"slug": {
"type": "string"
},
"category": {
"type": "string"
},
"name": {
"type": "string"
},
"description": {
"type": "string"
},
"method": {
"type": "string"
},
"path": {
"type": "string"
},
"provider": {
"type": "string"
},
"execution": {
"type": "object",
"properties": {
"mode": {
"type": "string"
}
},
"required": [
"mode"
],
"additionalProperties": false
},
"pricing": {
"type": "object",
"properties": {
"from": {
"type": "object",
"properties": {
"model": {
"type": "string"
},
"unit": {
"type": "string"
},
"baseUsd": {
"type": [
"null",
"number"
]
},
"perUnitUsd": {
"type": [
"null",
"number"
]
},
"maxUsd": {
"type": "number"
},
"maxPer1kUsd": {
"type": "number"
},
"addons": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"label": {
"type": "string"
},
"field": {
"type": "string"
},
"usd": {
"type": "number"
}
},
"required": [
"id",
"label",
"field",
"usd"
],
"additionalProperties": false
}
}
},
"required": [
"model",
"unit",
"maxUsd",
"maxPer1kUsd"
],
"additionalProperties": false
},
"failoverMaxUsd": {
"type": "number"
},
"failoverMaxPer1kUsd": {
"type": "number"
}
},
"required": [
"from",
"failoverMaxUsd",
"failoverMaxPer1kUsd"
],
"additionalProperties": false
},
"failover": {
"type": "boolean"
},
"excludesCallerDelay": {
"type": "boolean"
},
"heavy": {
"type": "boolean"
},
"relevance": {
"type": "number",
"description": "relative relevance in (0,1], 1.0 = the best match"
}
},
"required": [
"id",
"slug",
"category",
"name",
"description",
"method",
"path",
"provider",
"execution",
"pricing",
"failover",
"relevance"
],
"additionalProperties": false
}
},
"total": {
"type": "integer"
},
"ranking": {
"type": "string"
}
},
"required": [
"results",
"total",
"ranking"
],
"additionalProperties": false
}🟡send_feedback(contact, context, details, request_id, sku, ...)
Submit non-defect feedback to AnyAPI about an API you could not find in the catalog, a missing result field, confusing documentation or tool descriptions, or an improvement that would make a task easier. Free, never charged. `summary` is required and contains one line; optional `details` describes the task or suggestion.
Esquema de entrada
{
"type": "object",
"properties": {
"contact": {
"description": "optional: an email address for a reply; trial keys have no reachable account contact",
"type": "string"
},
"context": {
"description": "Brief purpose of this tool call within the requested task, used for analytics and user-intent tracking.",
"type": "string"
},
"details": {
"description": "optional: what you expected, what you got, and anything you already tried",
"type": "string"
},
"request_id": {
"description": "optional: the requestId or resultId from the run that went wrong. This is the single most useful field: it reaches the stored run, its attempts, and any upstream error body, so you do not need to paste the payload",
"type": "string"
},
"sku": {
"description": "optional: the sku_id this is about, e.g. 'instagram.reels_search'",
"type": "string"
},
"summary": {
"description": "one line saying what went wrong or what you want to tell us",
"type": "string"
}
},
"required": [
"summary",
"context"
]
}Esquema de salida
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "the stored report id for support correspondence"
},
"received": {
"type": "boolean",
"description": "true when the report is stored"
}
},
"required": [
"id",
"received"
],
"additionalProperties": false
}Comunidad
Evidencia