| 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
- Fetch the relevant config/list endpoint first when building UI or automation.
- Send JSON bodies with
Content-Type: application/json unless the endpoint specifies multipart upload.
- Preserve returned IDs; follow-up routes are ID-based.
- 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. |
