MCP

NDI speaks Model Context Protocol, so an agent can call parse, extract, search, and the rest as tools. Hosted and local servers expose the same catalog. Prefer uvx ndi-mcp (or pip install ndi-mcp). The older ndi-sdk[mcp] extra still resolves to that package.

	Hosted (`https://ndi-api.nace.ai/v1/mcp`)	Local (`uvx ndi-mcp`)
Install	none	Python 3.11+, `uvx`
Auth	`X-API-Key` or `Authorization: Bearer` header	`ndi-mcp login`, or `$NDI_API_KEY`
Files on your machine	public URLs only	uploaded straight from disk
Best for	quick setup, shared and CI agents	coding agents working on local files

Hosted

Paste this into the agent’s MCP config. Mint the key on the API keys page; do not commit it.

{
  "mcpServers": {
    "ndi": {
      "type": "http",
      "url": "https://ndi-api.nace.ai/v1/mcp",
      "headers": { "X-API-Key": "ndi_sk_..." }
    }
  }
}

The hosted server runs in our cloud, so it cannot see your filesystem. upload_document and upload_file refuse a local path there. Pass a public URL, or run the local server.

Local

uvx ndi-mcp login
claude mcp add ndi -- uvx ndi-mcp

ndi-mcp login opens the NDI console in your browser. Approve there; the CLI stores the minted key in ~/.ndi/config.toml. Pass --api-key (or set $NDI_API_KEY) to skip the browser. Cursor — add to .cursor/mcp.json:

{
  "mcpServers": {
    "ndi": {
      "command": "uvx",
      "args": ["ndi-mcp"]
    }
  }
}

opencode — add to opencode.json:

{
  "mcp": {
    "ndi": {
      "type": "local",
      "command": ["uvx", "ndi-mcp"]
    }
  }
}

$NDI_API_KEY is read first; otherwise the key saved by ndi-mcp login. Local files go through upload_document, then parse_document / extract_data with the returned upload_id.

Tools

Same catalog on hosted and local. Names map to the Python SDK:

MCP tool	SDK
`upload_document`	`client.documents.create_upload`
`parse_document`	`client.documents.parse`
`split_document`	`client.documents.split`
`classify_document`	`client.documents.classify`
`extract_data`	`client.documents.extract`
`ground_items`	`client.documents.ground`
`create_workspace`	`client.workspaces.create`
`upload_file` / `upload_and_ingest_file`	`client.files.upload` / `client.upload_and_ingest`
`ingest_workspace`	`client.ingestion.ingest`
`hybrid_search`	`client.tools.hybrid_search`
`qa_file`	`client.tools.qa_file`
`query_tables`	`client.tools.query_tables`

Ask get_documentation with a topic (parse, extract, auth, workspaces, …) before writing integration code.

Getting started

SDKs and agents

Concepts

Hosted

Local

Tools

Next steps

​Hosted

​Local

​Tools

​Next steps

Hosted

Local

Tools

Next steps