# Git.Top Agent Entry Point

Git.Top is an agent-native GitHub project knowledge layer for open-source discovery, comparison, deployment fit, alternatives, quality signals, and MCP access.

## Preferred Agent Flow

1. Check `GET /api/health` and `GET /api/trust`.
2. Read `GET /api/agent-map` for the shortest useful route across REST and MCP surfaces.
3. Use `GET /openapi.json` for REST clients or `GET /mcp` for MCP tool discovery.
4. Use `GET /llms.txt` first, then `GET /llms-full.txt` for the full operating guide.
5. Pass strict source controls such as `require_d1=true` or `require_d1: true` when seed fallback should fail closed.

## Discovery URLs

- llms.txt: https://git.top/llms.txt
- Full agent guide: https://git.top/llms-full.txt
- OpenAPI: https://git.top/openapi.json
- API catalog: https://git.top/.well-known/api-catalog.json
- MCP server card: https://git.top/.well-known/mcp.json
- MCP endpoint: https://git.top/mcp
- Agent skills: https://git.top/.well-known/skills.json
- Auth policy: https://git.top/auth.md
- Agent manifest: https://git.top/.well-known/agents.json
- Sitemap: https://git.top/sitemap.xml
- Robots and Content-Signal policy: https://git.top/robots.txt

## Public Capabilities

- Search open-source projects by query, category, deployment, language, and Cloudflare readiness.
- Retrieve structured project knowledge, evidence, metrics, graph relationships, alternatives, and score explanations.
- Build agent workflows for recommendation, comparison, graph reasoning, ecosystem exploration, quality review, and trust preflight.