Skip to main content
Preview. The Tools API is in preview. It requires a key with the api:call scope, which you create in the app under Settings > Developer Keys > API Keys. See Authentication.
The Nikiwa Tools API exposes a curated set of analysis tools as a REST API. Each tool takes exact inputs and returns a structured data object, the same data the app renders as modules, handed to you raw.
The Tools API is deterministic and data-only. It does not route intent, interpret, or synthesize; that reasoning is your application’s job. For a reasoning layer over the same tools, connect an assistant via the MCP server.

​
Base URL

​
The two surfaces

The API separates discovery (free, read-only) from execution (charged in credits).
Only a curated allowlist of tools is public. A tool that is not on the allowlist returns 404; it is neither listed by discovery nor callable. The full tool set is available through the MCP server.

​
Typical flow

1

Get a key

Create a key with the api:call scope in the app. See Authentication.
2

Discover

Call GET /api/tools to see which tools exist and what inputs each expects.
3

Execute

Call POST /api/tools/{tool_name} with the tool’s inputs as a JSON body. Each call costs the tool’s price in credits.

​
Response shape

Every tool returns a JSON object. On success that is the tool’s data. When a tool has nothing to return, or hits a problem, it returns a status marker instead:
See Errors & status for the full contract.

Authenticate

How to pass your API key.

Credits & Pricing

What each tool costs, and when calls are refunded.