# AaaS Knowledge Index
> The AI entity intelligence layer — 1451 entities across 16 types, scored, compared, and clustered.

## What This Is
AaaS Knowledge Index is a structured database of AI tools, models, agents, frameworks, platforms, and more. Every entity is scored on adoption, quality, freshness, citations, and engagement. Entities are connected through similarity graphs, use-case clusters, and head-to-head comparisons.

## Entity Types
  - tool: 284 entities
  - model: 228 entities
  - agent: 167 entities
  - skill: 120 entities
  - paper: 119 entities
  - dataset: 101 entities
  - script: 90 entities
  - integration: 83 entities
  - benchmark: 80 entities
  - provider: 60 entities
  - hardware: 40 entities
  - platform: 18 entities
  - startup: 17 entities
  - use-case: 17 entities
  - framework: 14 entities
  - marketplace: 13 entities

## API Access

### MCP Server
Connect from any MCP-compatible client:
  URL: https://aaas.blog/api/mcp
  Transport: SSE

### REST API v1
Base URL: https://aaas.blog/api/v1

Endpoints:
  GET /entities              — Search and list entities (filter by type, category, query)
  GET /entities/:type/:slug  — Entity detail
  GET /entities/:type/:slug/similar — Similar, complementary, and alternative entities
  GET /entities/:type/:slug/graph   — Graph neighbors
  GET /clusters              — Use-case clusters
  GET /clusters/:slug        — Cluster detail
  GET /compare/:typeA/:slugA/vs/:typeB/:slugB — Head-to-head comparison
  GET /stacks                — Curated technology stacks for common use cases
  GET /stacks/:slug          — Stack detail
  GET /solve                 — Find stacks by use case
  GET /categories            — Category index with entity counts
  GET /graph                 — Paginated relationship graph export
  GET /feed/new              — Recently added entities
  GET /feed/trending         — Highest-scored entities
  GET /feed/updated          — Recently updated entities
  GET /feed/stacks           — Latest use-case stacks

### Proxy API (Execute AI models through AaaS)
Base URL: https://aaas.blog/api/v1

Endpoints:
  POST /run/{slug}             — Execute any model/tool by entity slug
  POST /run                    — Smart routing (describe task, get recommendation + alternatives)
  GET  /run/{slug}             — Model capabilities + example request format
  GET  /catalog                — Browse all callable entities (filter by modality, provider, tier)
  GET  /providers              — List providers with model counts and availability
  GET  /providers/{slug}       — Provider detail with all routable models
  GET  /usage                  — API key usage stats (requires x-api-key)

Supported Providers: HuggingFace Inference API, Replicate, fal.ai, Together AI, Groq, Fireworks AI
Auth: x-api-key header (get key at /api/developer/api-keys)
Tiers: free (100 calls/day, 3 providers), pro ($39/mo, all providers), business ($99/mo, priority)

### Response Format
All endpoints return: { data, meta: { source, version, timestamp }, links }

## Scoring Methodology
Each entity is scored 0-100 on five dimensions:
  - Adoption (40%): GitHub stars, downloads, market presence
  - Citations (25%): Academic and industry references
  - Quality (20%): Documentation, API design, reliability
  - Engagement (15%): Community activity, recent commits
  - Composite: Weighted average of all dimensions

## Enrichment Data
  - entity_similarities: 1451 documents — similar, complementary, alternative relationships
  - entity_graph: 6,000+ edges — integrates-with, alternative-to, complements
  - entity_clusters: Use-case groupings with AI-generated names
  - comparisons: Head-to-head analyses with dimension scores
  - use_case_stacks: Curated technology combinations for common problems

## About
Built by AaaS (Agents as a Service) — https://agents-as-a-service.com
Contact: hello@aaas.name