Developer Resources

Developer API Documentation

Interface specs for building integration tooling

🔑

Is authentication required?

All external API and MCP requests require an API key passed in the x-api-key header. To request a developer API key, please contact [email protected].

Integrate AIWebsiteDirectory list index feeds directly into your widgets, dashboard analytics, or developer tools. All responses are returned in standard JSON formats.

GET/api/products

Retrieve a list of all published artificial intelligence tools ranked by community upvotes.

// Headers: x-api-key: your_api_key_here
[
  {
    "id": "clt1abcde000008j12345",
    "name": "Super AI Creator",
    "url": "https://superaicreator.com",
    "tagline": "The absolute fastest way to generate web components",
    "description": "An interactive AI agent designed to write and ship clean code on the fly.",
    "category": "Development",
    "tags": ["AI Coding", "Developer Productivity"],
    "votes": 128,
    "logoUrl": "https://r2.domain.com/logos/clt1abc.png",
    "screenshotUrl": "https://r2.domain.com/screenshots/clt1abc.png"
  }
]

GET/api/categories

Retrieve a complete list of all supported directory categories along with counts of published tools in each.

// Headers: x-api-key: your_api_key_here
[
  {
    "name": "Development",
    "slug": "development",
    "count": 42
  },
  {
    "name": "LLMs",
    "slug": "llms",
    "count": 18
  }
]

MCP/api/mcp

AIWebsiteDirectory supports the **Model Context Protocol (MCP)**. This lets LLMs (such as Claude Desktop) call directory tools directly to search tools, browse categories, or fetch tool specs.

How do I add the MCP server to Claude Desktop?

Open your Claude Desktop config file and specify your server configuration, including the x-api-key request header mapping:

{
  "mcpServers": {
    "ai-website-directory": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/client-sse",
        "https://aiwebsitedirectory.com/api/mcp?sessionId=claude-desktop"
      ],
      "env": {
        "x-api-key": "YOUR_API_KEY_HERE"
      }
    }
  }
}