# URLCode AI

URLCode AI offers a versioned skill catalog, revision-matched reference tools, and a stateless MCP endpoint. Start with POST https://api.urlcode.ai/mcp and call `urlcode_task_plan` before writing URLCode YAML. Its response gives the exact pinned `@jimhoyd/urlcode` install target for this service revision.

## Endpoints

- `GET https://api.urlcode.ai/api/v1/skills`: list enabled skills.
- `GET https://api.urlcode.ai/api/v1/skills/{skill}`: read one versioned skill.
- `POST https://api.urlcode.ai/api/v1/feedback`: submit bounded feedback.
- `POST https://api.urlcode.ai/mcp`: stateless JSON-RPC MCP.

## Connect an MCP client

`{ "mcpServers": { "urlcode-ai": { "type": "http", "url": "https://api.urlcode.ai/mcp" } } }`

Hosted tools return guidance and bounded reference data only. Inspect, validate, and test a real project with local `urlcode mcp` or the URLCode CLI.