# MCP App view

MCP hosts that support **MCP Apps** (the MCP UI extension) can show JustClaw-It results as an interactive view instead of raw JSON. Hosts that don't support it get exactly the same JSON text, so nothing changes for them.

## What it shows

- **Search results** (`search_components`, `find_similar`): a card per component with repository, path, language, licence, lines of code, scores, similarity, tags, the attribution line and the GitHub permalink, plus a filter box that narrows the list by name, repo, language or tag.
- **One component** (`get_component`): the same card with dependencies and the component id, the source code, and a **Copy source** button.
- Errors from the tool (for example running out of credits) as a readable message.

## How it works

- The tools declare the view in their metadata (`_meta.ui.resourceUri` = `ui://justclaw-it/components.html`). The view is a resource with MIME type `text/html;profile=mcp-app`.
- The host renders it in a sandboxed frame. It only displays what the tool already returned: **it never calls tools itself**, so it can never spend a credit.
- Reading the view resource is free.
- The view loads the MCP Apps helper library from `unpkg.com`, the only external domain its content-security metadata declares.

The view picks up the host's light or dark theme and style variables when the host provides them.