nace-mcp

An MCP server for the Drex API: coding agents get calibrated decisions and document jobs as tools. MIT; built on nace-sdk.

nace-mcp login                           # or: uvx nace-mcp login; paste a key from https://console.nace.ai/dashboard/api-keys
claude mcp add nace -- uvx nace-mcp      # Claude Code

nace-mcp login checks the key against Drex and saves it to ~/.nace/config.toml (mode 0600), the file nace login from nace-cli writes too, so either signs in both. --api-key KEY passes the key, --api-key - reads it from stdin; without a terminal one of them is required. $NACE_API_KEY, $NACE_BASE_URL and $NACE_CONFIG_PATH in the server's environment override the file. Without a key the server still starts, and every tool answers with how to sign in until one is saved. The server reads the credentials on each call, so nace-mcp login while it runs, to sign in or to replace a refused key, needs no restart. nace-mcp --version prints the server and SDK versions.

Connect an agent

Codex: codex mcp add nace -- uvx nace-mcp (or a [mcp_servers.nace] table with command = "uvx" and args = ["nace-mcp"] in ~/.codex/config.toml).

OpenCode (opencode.json): "mcp": {"nace": {"type": "local", "command": ["uvx", "nace-mcp"], "enabled": true}}.

Claude Desktop (claude_desktop_config.json) and Cursor (.cursor/mcp.json):

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

Add "env": {"NACE_API_KEY": "nace_sk_..."} to pass a key without nace-mcp login. To install it once instead of through uvx: pipx install nace-mcp (Python 3.11 or later), then use nace-mcp as the command.

Tools

The document tools take one source: an https:// url, a local path (uploaded first), an uploaded file's workspace_id and file_id, or a finished parse's parse_job_id. They wait up to wait_seconds (60 at most) and return the job; one still running comes back with an instruction to call wait_for_job. Any other request field goes in a tool's options; an argument a tool doesn't have is refused rather than ignored. Results are summarised, and text or JSON longer than max_inline_chars is written to a file readable only by you, whose path is returned. For a document too large to return inline, parse_document saves the full Markdown to a file.

Full documentation: MCP server.