appnz-mcp-servers-api

name	appnz-mcp-servers-api
description	Use this skill for app.nz MCP server directory APIs under /api/mcp-servers, including listing, searching, filtering, and retrieving install/transport metadata for external MCP connectors. Distinguish this from POST /mcp, which is app.nz's own MCP transport.

app.nz MCP Servers Directory

Use these app.nz control-plane APIs with Authorization: Bearer pk_live_.... Treat responses as JSON. Public config/list endpoints may work without auth, but write routes and user data routes require auth.

Workflow

1. Fetch the relevant config/list endpoint first when building UI or automation.
2. Send JSON bodies with Content-Type: application/json unless the endpoint specifies multipart upload.
3. Preserve returned IDs; follow-up routes are ID-based.
4. On errors, check status and JSON error; do not retry write calls blindly.

Endpoints

Method	Path	Use
GET	/api/mcp-servers	List indexed MCP servers.
GET	/api/mcp-servers/search?q=...	Search MCP servers by use case.
GET	/api/mcp-servers/{id}	Read one MCP server's metadata.
POST	/mcp	Use the app.nz MCP transport, not the directory API.