APIClaw

Install · Universal detected

Install APIClaw.

One layer for every AI agent. Pick the path that fits your machine, or skip install and use the HTTP API after signing in.

Terminal

Three steps.

  1. 01

    Install

    One-line install · macOS

    Detects Node.js. Installs via Homebrew, falls through to the official .pkg if brew is missing. Then registers the APIClaw MCP server.

  2. 02

    Sign in

    Required before any API call. Opens a browser, writes ~/.apiclaw.toml. Headless? Open the printed URL on another device.

  3. 03

    Verify

    Must print your email. Then restart Claude Desktop and try NASA APOD: call_api with provider nasa, action apod.

No terminal

Install for Claude Desktop.

Download the .mcpb file. Double-click it. Claude Desktop installs it as an extension. No Node.js, no terminal, no config file editing.

Download apiclaw.mcpb

Building an agent?

Call from any language.

Run npx @nordsym/apiclaw auth login, then use your saved session with X-APIClaw-Session. Every call sends provider and action to the same execute endpoint. No key copy-paste.

npx @nordsym/apiclaw auth whoami || exit 1
SESSION=$(node -e 'const fs=require("fs"),os=require("os"),p=require("path");const t=p.join(os.homedir(),".apiclaw.toml");const m=fs.existsSync(t)&&fs.readFileSync(t,"utf8").match(/session_token\s*=\s*"([^"]+)"/);if(!m||!m[1].trim())process.exit(1);process.stdout.write(m[1])')
if [ -z "$SESSION" ]; then echo "Sign in first: npx @nordsym/apiclaw auth login"; exit 1; fi
curl -sS --fail-with-body --max-time 30 https://api.apiclaw.cloud/v1/execute \
  -H "Content-Type: application/json" \
  -H "X-APIClaw-Session: $SESSION" \
  -H "Idempotency-Key: docs-nasa-$(date +%s)" \
  -d '{"provider":"nasa","action":"apod","params":{}}'
Sign up freeAPI reference

Troubleshooting.

Still stuck? File an issue at github.com/nordsym/apiclaw/issues with your OS, terminal output, and Node version. We respond fast.

‘npx’ is not recognized (Windows)

Node.js is not installed. The install.ps1 script handles this automatically. Re-run it in PowerShell:

If that fails (locked-down corporate network), install Node.js LTS manually from nodejs.org, then re-run.

PowerShell execution policy blocks the script

Run this once, then retry the install:

winget is not available (Windows < 1809)

The installer falls through to Chocolatey, then to a direct .msi download. If both fail, install Node.js manually from nodejs.org and re-run.

‘command not found: brew’ (macOS)

The installer falls through to a direct .pkg download. If that asks for a password and you don't have admin rights, install Node.js LTS via nodejs.org or via nvm.

My Linux distro isn't auto-detected

The installer covers apt / dnf / yum / pacman / zypper / apk. For anything else, install Node.js 18+ via your package manager, then run:

Claude Desktop doesn't see APIClaw after install
  1. Quit and relaunch Claude Desktop.
  2. Open ~/Library/Application Support/Claude/claude_desktop_config.json on macOS or %APPDATA%\Claude\claude_desktop_config.json on Windows.
  3. Confirm an apiclaw entry under mcpServers.
  4. If missing, run the install one more time, or paste the snippet from the home page Three Doors section manually.
Behind a corporate proxy / firewall

Set npm to your proxy first:

Then run the installer. If outbound to api.apiclaw.cloud is blocked, the MCP client will install but calls will fail. Talk to your IT to allowlist apiclaw.cloud and api.apiclaw.cloud.

Uninstall