# MCP Catalog API

> Search and discovery engine for 30,000+ MCP servers and AI agents. Hybrid semantic search, trust scoring, vulnerability tracking.

## Quick Start (for agents)

```
curl -H 'Accept: application/json' https://knyazevai.work/
```
Returns a JSON directory of all machine-readable endpoints.

Or go straight to search:
```
curl 'https://knyazevai.work/api/v1/servers/search?q=your+task+here'
```

## Docs
- Agent directory (JSON): `curl -H 'Accept: application/json' https://knyazevai.work/`
- [Interactive API docs (Swagger UI)](/docs)
- [OpenAPI spec](/openapi.json)
- [A2A agent card](/.well-known/agent.json)
- MCP server (SSE): `https://knyazevai.work/sse`

## API
- **Base URL:** `https://knyazevai.work/api/v1`
- **Auth:** None (public API)
- **Format:** JSON (application/json)
- **Rate limits:** 15 req/min (search), 10 req/min (list), 30 req/min (detail)

### Endpoints

| Method | Path | Description |
|--------|------|-------------|
| GET | `/api/v1/servers/search?q={query}` | Semantic search — describe what you need |
| GET | `/api/v1/discover?task={task}` | Top recommendations for a task |
| GET | `/api/v1/servers?sort_by=&limit=&transport_type=&protocol=` | Browse/filter servers |
| GET | `/api/v1/servers/{id}` | Full detail: tools, packages, install command, trust breakdown |
| GET | `/api/v1/servers/{id}/vulnerabilities` | CVE/GHSA security data |
| GET | `/api/v1/categories` | All categories with server counts |
| GET | `/health` | Health check |

### Key response fields
- `source_authority` — official / vendor / community / unknown
- `resource_kind` — mcp_server / a2a_agent / rest_api
- `trust_score` (0-100) — composite: source credibility, popularity, completeness, freshness, security
- `cosine_similarity` (0-1) — semantic match score (search only)
- `transport_type` — stdio / sse / streamable-http
- `install_command` / `install_snippet` — ready-to-run install command
- `requires_api_key` — true/false
- `readme_summary` — AI-generated 2-3 sentence summary
- `protocol` — mcp, a2a, rest, openapi
- `pricing_model` — free, paid, freemium

## MCP Server

Connect as MCP client (Claude Desktop, Cursor, etc.):

**SSE endpoint:** `https://knyazevai.work/sse`

**Tools:** search_servers, list_servers, get_server, discover, get_server_vulnerabilities, get_catalog_stats