Developer Platform

API & MCP Server Documentation

Programmatic REST endpoints and Model Context Protocol specifications for AIWebsiteDirectory.com.

Authentication Required

All external API and MCP requests require an API key passed in the x-api-key header. Request a developer key via [email protected].

GET/api/products

Retrieve 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 fastest way to generate web components",
    "description": "An interactive AI agent designed to write and ship clean code.",
    "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 supported directory categories along with published tool counts.

// 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) so desktop AI clients (such as Claude Desktop or Cursor) can query directory listings, categories, and rubric scores directly.

Claude Desktop Configuration

Add the server entry to your client config with your x-api-key mapped:

{
  "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"
      }
    }
  }
}