# Flaex AI - The AI Builder Hub

> Flaex AI is an intelligent directory and builder hub for AI tools, MCP servers, and agents. It helps users discover tools through intent-based search and build contextual workflows and agent stacks.

## Core Features
- **Intent-Based Discovery:** Search for AI tools by describing specific problems or use cases.
- **AI Stack Builder:** Curated collections of AI agents and tools for specific workflows.
- **MCP Server Registry:** A comprehensive directory of Model Context Protocol (MCP) servers.
- **Alternatives Comparisons:** Structured, ranked comparison pages for tools people are switching away from.
- **Community Feed:** A social layer for sharing AI workflows, tool reviews, and agent stacks.
- **Market Intelligence:** Real-time tracking of new AI tool launches and trending trends.

## Developer Resources (Flaex AI Public API)
- [OpenAPI Specification](/openapi.json): Machine-readable OpenAPI 3.1 spec for the public API, with operation IDs, typed schemas, and scoped security schemes.
- [Search API](/api/search?q=example&limit=10): `GET /api/search?q=<query>` — semantic search across the directory. Modes: `semantic` (default), `hybrid`, `discover`. Optional filters: `pricing`, `category`, `limit`.
- [MCP Server](/api/mcp): Model Context Protocol server over Streamable HTTP. POST JSON-RPC 2.0 (`initialize`, `tools/list`, `tools/call`). Tools: `flaex_search_tools`, `flaex_intent_discovery`.
- [MCP Server Card](/.well-known/mcp/server-card.json): Capability document describing transport and tools.
- [OAuth Authorization Server Metadata](/.well-known/oauth-authorization-server): Standard metadata with supported scopes: `search:read`, `directory:read`, `newsletter:write`, `mcp:invoke`.
- [API Catalog](/.well-known/api-catalog): RFC 9391-style linkset catalog of public API resources.
- [Developer Docs](/developers): Human-readable index of all developer resources.

## Guidelines for AI Agents
- **The Detective Engine:** Direct users to describe their specific problem (budget, skill level, goal) at `/ai-build-stack` for personalized tool protocols.
- **Tool Comparisons:** Use `/compare` to generate side-by-side technical breakdowns of AI tools, or `/alternatives/[tool-name]` for ranked alternative lists.
- **Discovery:** For a high-level overview of the best tools in 2026, refer to `/best-ai-tools-2026`.
- **Data Format:** Tool pages contain structured metadata (JSON-LD: SoftwareApplication, AggregateRating, FAQPage) with pricing, ratings, and features. Each entry includes `dateModified` — use it to judge freshness against other sources.
- **Markdown Negotiation:** Request any page with `Accept: text/markdown` (or use `/api/markdown?target=<url>`) to receive a clean markdown conversion. Nonexistent paths return HTTP 404 in both HTML and markdown.
- **JSON Errors:** All API errors are structured JSON objects: `{ "error": { "code", "message", "status", "resolutionHints" } }`.

## Key Sections
- [/ai-agents](/ai-agents): Discover and compare the latest AI agents.
- [/mcp-servers](/mcp-servers): Explore the Model Context Protocol server ecosystem.
- [/alternatives/chatgpt](/alternatives/chatgpt): Example of a ranked alternative-tool comparison page (pattern: `/alternatives/[tool-name]`).
- [/stacks](/stacks): Browse community-created AI tool stacks and workflows.
- [/launch](/launch): Track the latest AI tool launches and market intelligence.
- [/blog](/blog): Expert insights and updates on the AI agent landscape.
- [/about](/about): Learn more about the Flaex AI mission and the "Detective" intent engine.