Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.nippy.la/llms.txt

Use this file to discover all available pages before exploring further.

All error responses include a detail field with specific context.
When reporting an error to support@nippy.la, include the request_id, the detail field, and the action you were running.

​
HTTP codes

Cause: The API key is missing, misspelled, or doesn’t use the npk_ prefix.Fix: Send the X-API-Key header with a valid key.
curl https://ms.nippy.la/cognitive-layer/mcp \
  -H "X-API-Key: npk_your_api_key_here"
Cause: The key doesn’t have permissions for the vertical, tool, or resource requested.Fix: Review permissions from the console and confirm the resource belongs to your business.
{
  "error": "forbidden",
  "detail": "Key does not have access to this tool"
}
Cause: The client sent too many requests in a short period.Fix: Wait a few seconds and spread calls over time.
await new Promise(resolve => setTimeout(resolve, 2000))
Cause: An internal error occurred while executing the request.Fix: Retry later. If it persists, report the request_id.
{
  "error": "internal_server_error",
  "request_id": "req_abc123"
}

​
Common tool errors

Cause: The key is not tied to a specific business.Fix: Use an npk_* API key created from https://console.nippy.la/settings/api-keys.
X-API-Key: npk_your_api_key_here
Cause: No data for the date range or the queried area does not contain that type of information.Fix: Try a wider range and confirm the queried collection is correct.
{
  "collection": "roulettesMaterializedView",
  "dateRange": "last_90_days"
}
Cause: The roulette ID doesn’t exist or belongs to another business.Fix: Use roulettes_list_roulettes to get valid IDs.
List my active roulettes and their IDs
Cause: The center, product, or stock doesn’t pass server validation.Fix: Verify IDs with supply_list_nippy_centers and supply_list_nippy_center_stocks before retrying.
Show me the available stock by center before registering the withdrawal