API Reference

Tools API

Programmatic access to the 4agent tool catalog. No authentication required. All responses are JSON. Base URL:

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

GET/api/tools

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

Example

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

Response

{
  "count": 27,
  "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,
        "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.

Parameters

qstringSearch query. Matches against name, tagline, description, categories, tags, and SDK fields.

Example

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

Response

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

GET/api/tools?category={category}

Filter tools by category.

Parameters

categorystringCategory slug. Options: sandbox, code-execution, email, communication, browser, web-scraping, file-storage, database, memory, vector-db, payment, auth, identity, monitoring, observability, search, data, deployment, hosting.

Example

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

Response

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

GET/api/tools?id={id}

Retrieve a single tool by its ID.

Parameters

idstringThe tool's unique identifier (kebab-case slug).

Example

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

Response

{
  "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,
      "openapi": true,
      "sdk": ["typescript", "python"]
    },
    "tags": ["llm", "ai", "inference", "api"],
    "verified": true
  }
}

Error Responses

404Tool not found. Returned when querying by ID and no matching published tool exists.

{ "error": "Tool not found" }

Agent Usage

This API is designed for AI agents to discover and evaluate tools programmatically. Example agent workflow:

// 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