| name | appnz-mcp-api |
| description | Use this skill for the app.nz MCP server at POST /mcp or /v1/mcp, including initialize, tools/list, tools/call, chat, list_models, generate_image, embed, and MCP directory search. |
app.nz MCP API
Use POST /mcp on app.nz. Authenticate with an app.nz bearer key unless the endpoint is explicitly public.
Workflow
- Initialize the MCP session with JSON-RPC method
initialize when acting as an MCP client.
- Call
tools/list to discover app.nz tools; current tools include chat, list_models, generate_image, embed, and search_mcp_servers.
- Call
tools/call with app.nz model IDs such as app/auto; gateway routing, BYOK, metering, and billing are reused under the hood.
- Use
/api/mcp-servers only when searching the external MCP-server directory; it is not the MCP transport.
Example
curl -sX POST https://app.nz/mcp \
-H "Authorization: Bearer pk_live_..." \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_models","arguments":{"filter":"gemini"}}}'
Notes
/mcp is the app.nz MCP transport: JSON-RPC requests dispatch to gateway handlers and share gateway auth, BYOK, billing, fallback, and metering./api/mcp-servers is a directory/search API for external MCP servers; use appnz-mcp-servers-api for that surface.- Use MCP
tools/list to discover chat, list_models, generate_image, embed, and search_mcp_servers.
Relevant Models
This API is not model-catalogue-driven.
