ip-catalog

# AI Apps GBB IP Catalog — MCP Discovery > [!IMPORTANT] > **This skill requires an MCP server connection to work.** The tools below call > the IP catalog MCP server — without it connected, the skill has no tools available. > > **Setup:** Run `/mcp add` in Copilot CLI and configure the server below, OR > ask the skill to set it up for you: *"set up the ip-catalog MCP server"*. > > **API Key:** Ask the AI Apps GBB admin team for the `MCP_API_KEY`. The key is > managed in Azure Container Apps secrets — it's not publicly available. ## MCP Server Connection The IP catalog is exposed as an MCP server with Bearer token authentication. ### Endpoint ``` https://admin-mcp-t7l5hqkuhsv2s.kindbay-2d11d96b.eastus2.azurecontainerapps.io/mcp ``` ### Authentication All requests require a Bearer token in the `Authorization` header: ``` Authorization: Bearer <MCP_API_KEY> ``` ### Auto-Setup If the MCP server is not yet connected, add it to your config. The skill should offer to do this automatically by writing to the appropriate config file: **For GitHub Copilot CLI** (`~/.copilot/mcp-config.json`): ```json { "mcpServers": { "ip-catalog": { "url": "https://admin-mcp-t7l5hqkuhsv2s.kindbay-2d11d96b.eastus2.azurecontainerapps.io/mcp", "headers": { "Authorization": "Bearer ${MCP_API_KEY}" } } } } ``` **For VS Code** (`.vscode/mcp.json` or user settings): ```json { "mcpServers": { "ip-catalog": { "url": "https://admin-mcp-t7l5hqkuhsv2s.kindbay-2d11d96b.eastus2.azurecontainerapps.io/mcp", "headers": { "Authorization": "Bearer ${MCP_API_KEY}" } } } } ``` Set `MCP_API_KEY` as an environment variable, or replace `${MCP_API_KEY}` with the actual key. > **Note:** The API key is stored in Azure Container Apps secrets and managed by the admin team. > Contact the AI Apps GBB admins to get access. --- ## Available Tools ### `search_ips` Search the IP catalog by keyword with optional filters. **Parameters:** - `query` (string, required): Search term — matches against name, description, industry, tags, authors - `services` (list[string], optional): Filter by Azure service (e.g. `["Azure OpenAI", "Cosmos DB"]`) - `patterns` (list[string], optional): Filter by pattern (e.g. `["RAG", "Multi-Agent"]`) **Returns:** JSON array of matching IPs. **Example:** ```json { "name": "search_ips", "arguments": { "query": "insurance", "patterns": ["Multi-Agent"] } } ``` --- ### `list_ips` List all IPs with optional filters. Good for browsing the full catalog. **Parameters:** - `services` (list[string], optional): Filter by Azure service - `patterns` (list[string], optional): Filter by pattern **Returns:** JSON with `ips` array, `total_count`, `total_unfiltered`, and `filters`. --- ### `get_ip_details` Get full details for a specific IP by repository name. **Parameters:** - `repo_name` (string, required): The repository name (e.g. `"insurance-multi-agent"`) **Returns:** JSON object with all metadata for the IP. --- ### `get_ip_thumbnail` Get the thumbnail image for an IP. **Parameters:** - `repo_name` (string, required): The repository name **Returns:** JSON with `thumbnail_url` or `thumbnail_data_uri` (base64). --- ### `get_ip_readme` Get the README markdown content for an IP. **Parameters:** - `repo_name` (string, required): The repository name **Returns:** Markdown text of the IP's README. --- ### `get_filters` Get all available filter values for browsing. **Returns:** JSON with `services` and `patterns` arrays. --- ## Common Workflows ### Find IPs related to a topic ``` search_ips(query="RAG") → browse results → get_ip_details(repo_name="...") → get_ip_readme(repo_name="...") ``` ### Browse all IPs by service ``` get_filters() → list_ips(services=["Azure OpenAI"]) → get_ip_details(repo_name="...") ``` ### Get a quick overview ``` list_ips() → shows all IPs with total count and filters ``` --- ## Architecture The MCP server is a thin proxy deployed as a standalone Azure Container App: - **No EasyAuth** — authenticated via API key only - **Proxies to admin API** — calls the admin catalog endpoints using Entra ID client credentials - **Stateless HTTP** — no session affinity required, scales 0–3 replicas - **Source:** `src/mcp/` in the `aiappsgbb/admin` repo The data originates from the `aiappsgbb/index` repo's `registry/index-light.json` (for basic metadata) and the full index (for thumbnails and READMEs), cached in the admin API.