AI Design Taste API Documentation

The AI Design Taste API provides programmatic access to our catalog of design systems from top brands. This API is designed for AI agents and developers who want to integrate design system data into their applications.

Base URL

https://aidesigntaste.com/api

Authentication

No authentication is required. All endpoints are publicly accessible.

Endpoints

GET /design-systems

Retrieve the complete catalog of design systems.

Query Parameters

category (optional) - Filter by category: AI, Fintech, Developer Tools, Productivity, Automotive, Design, E-commerce, Technology

Example Request

GET /api/design-systems?category=Fintech

Example Response

{
  "systems": [
    {
      "id": "stripe",
      "name": "Stripe",
      "category": "Fintech",
      "logo": "https://cdn.brandfetch.io/stripe.com/w/400/h/400",
      "designMdUrl": "https://aidesigntaste.com/design-md/stripe",
      "apiUrl": "https://aidesigntaste.com/api/design-systems/stripe"
    }
  ],
  "total": 1,
  "categories": ["AI", "Fintech", "Developer Tools", ...]
}

GET /design-systems/{id}

Get detailed information about a specific design system.

Path Parameters

id (required) - Design system identifier (e.g., "stripe", "linear.app")

Example Request

GET /api/design-systems/stripe

Example Response

{
  "id": "stripe",
  "name": "Stripe",
  "category": "Fintech",
  "logo": "https://cdn.brandfetch.io/stripe.com/w/400/h/400",
  "designMdUrl": "https://aidesigntaste.com/design-md/stripe",
  "designMdContent": "# Stripe Design System\n\n...",
  "webUrl": "https://aidesigntaste.com/design-md/stripe",
  "lastUpdated": "2026-05-05T14:43:10.000Z"
}

POST /submit-brand

Submit a brand for inclusion in the design systems catalog.

Request Body

{
  "brandName": "Example Brand",
  "website": "https://example.com",
  "email": "contact@example.com",
  "category": "Technology",
  "designSystemUrl": "https://example.com/design-system",
  "message": "Optional message"
}

Response

{
  "success": true,
  "message": "Brand submission received successfully"
}

GET /health

Check API health status.

Response

{
  "status": "healthy",
  "timestamp": "2026-05-05T14:43:10.000Z",
  "version": "1.0.0",
  "services": {
    "database": "operational",
    "api": "operational"
  }
}

AI Agent Integration

MCP (Model Context Protocol)

We provide an MCP server card for easy integration with AI agents:

Server Card: /.well-known/mcp/server-card.json
Base URL: https://aidesigntaste.com/api

Agent Skills

Discover available agent skills for design system analysis:

Skills Index: /.well-known/agent-skills/index.json
Design System Analyzer: Extract design patterns and tokens
Style Guide Generator: Generate comprehensive brand guidelines
UI Component Matcher: Match components to design patterns
Design Token Extractor: Extract and convert design tokens

WebMCP

Our website supports WebMCP for browser-based AI agent interactions. The following tools are available:

get_design_systems - Get design systems catalog
get_design_system - Get specific design system details
search_design_systems - Search design systems
submit_brand - Submit a brand for inclusion

Content Negotiation

The homepage supports markdown content negotiation for AI agents:

GET / 
Accept: text/markdown

Rate Limits

Currently, there are no rate limits on the API. Please use responsibly.

Support

For API support or questions, visit aidesigntaste.com