Referencia de la API

API de herramientas

Acceso programático al catálogo de 4agent, sin autenticación y con respuestas JSON. URL base:

https://4agent.dev/api/tools

Contrato legible por máquinas: OpenAPI 3.1 JSON · Inicio rápido para desarrolladores

El contrato sigue Especificación OpenAPI 3.1 y la semántica de respuestas HTTP definida por RFC 9110.

GET/api/tools

List all published tools. Returns the full catalog sorted by name.

Parámetros

localestringIdioma opcional: en, zh-CN, ja o es. Por defecto en; los ID y campos del protocolo se conservan.

Ejemplo

curl https://4agent.dev/api/tools

Respuesta

{
  "count": 211,
  "tools": [
    {
      "id": "browserbase",
      "name": "Browserbase",
      "tagline": "Headless browser infrastructure built for AI agents",
      "category": ["browser", "web-scraping"],
      "description": "...",
      "url": "https://www.browserbase.com",
      "api_endpoint": "https://api.browserbase.com",
      "auth_method": "api_key",
      "pricing": {
        "model": "usage",
        "free_tier": true,
        "starting_price": "$0/month"
      },
      "integration": {
        "mcp": true,
        "cli": false,
        "openapi": false,
        "sdk": ["typescript", "python"]
      },
      "tags": ["browser", "playwright", "puppeteer", "automation"],
      "verified": true
    }
  ]
}

GET/api/tools?q={query}

Full-text search across tool names, taglines, descriptions, categories, tags, and SDKs. Add view=summary for a smaller card-ready payload.

Parámetros

qstringConsulta que busca en nombre, resumen, descripción, categorías, etiquetas y SDK.

view"summary"Opcional. Devuelve solo los campos necesarios para tarjetas.

Ejemplo

curl "https://4agent.dev/api/tools?q=email&view=summary"

Respuesta

{
  "count": 5,
  "tools": [
    {
      "id": "agentmail",
      "name": "AgentMail",
      "tagline": "Email inbox API for AI agents",
      ...
    },
    ...
  ]
}

GET/api/tools?category={category}

Filter tools by category.

Parámetros

categorystringSlug de categoría. Opciones: sandbox, code-execution, email, communication, browser, web-scraping, file-storage, database, memory, vector-db, payment, auth, identity, monitoring, observability, search, data, deployment, hosting, audio, video.

Ejemplo

curl "https://4agent.dev/api/tools?category=browser"

Respuesta

{
  "count": 9,
  "tools": [
    {
      "id": "browserbase",
      "name": "Browserbase",
      ...
    },
    ...
  ]
}

GET/api/tools?id={id}

Retrieve a single tool by its ID.

Parámetros

idstringIdentificador único de la herramienta (slug con guiones).

Ejemplo

curl "https://4agent.dev/api/tools?id=openrouter"

Respuesta

{
  "tool": {
    "id": "openrouter",
    "name": "OpenRouter",
    "tagline": "Unified API for 300+ LLMs",
    "category": ["data", "search"],
    "description": "...",
    "url": "https://openrouter.ai",
    "api_endpoint": "https://openrouter.ai/api/v1",
    "auth_method": "api_key",
    "pricing": {
      "model": "usage",
      "free_tier": true,
      "starting_price": "Pay per token"
    },
    "integration": {
      "mcp": false,
      "cli": false,
      "openapi": true,
      "sdk": ["typescript", "python"]
    },
    "tags": ["llm", "ai", "inference", "api"],
    "verified": true
  }
}

Respuestas de error

404Herramienta no encontrada. Se devuelve cuando no existe una herramienta publicada con ese ID.

{
  "error": "Tool not found",
  "code": "tool_not_found",
  "resolution": "Use GET /api/tools to list valid IDs or search with the q parameter."
}

Uso por agentes

Esta API permite a los agentes descubrir y evaluar herramientas mediante código. Ejemplo de flujo:

// Find tools that support MCP
const res = await fetch("https://4agent.dev/api/tools");
const { tools } = await res.json();
const mcpTools = tools.filter(t => t.integration.mcp);

// Search for a specific capability
const emailRes = await fetch(
  "https://4agent.dev/api/tools?q=email+inbox"
);
const { tools: emailTools } = await emailRes.json();

// Get details for a specific tool
const toolRes = await fetch(
  "https://4agent.dev/api/tools?id=agentmail"
);
const { tool } = await toolRes.json();
console.log(tool.api_endpoint); // https://api.agentmail.to