Installing the MCP server

1. Create an API key

In the NativPost dashboard, go to Settings → API keys and create a key. It looks like np_live_….

Copy it now — the key is shown once. API access requires a paid plan; see Authentication.

2. Add the server to your client

Claude Desktop

Edit claude_desktop_config.json:

macOS — ~/Library/Application Support/Claude/claude_desktop_config.json
Windows — %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "nativpost": {
      "command": "npx",
      "args": ["-y", "@nativpost/mcp"],
      "env": {
        "NATIVPOST_API_KEY": "np_live_your_key_here"
      }
    }
  }
}

Restart Claude Desktop. NativPost appears in the tools menu.

Claude Code

claude mcp add nativpost --env NATIVPOST_API_KEY=np_live_your_key_here -- npx -y @nativpost/mcp

Verify with:

claude mcp list

Other MCP clients

Run npx -y @nativpost/mcp with NATIVPOST_API_KEY set in the environment. The server speaks MCP over stdio.

3. Confirm it works

Ask your assistant:

“Use NativPost to show me my account plan and connected social accounts.”

It should call nativpost_get_account and nativpost_list_social_accounts and report your plan and platforms.

Configuration

Variable	Required	Default	Purpose
`NATIVPOST_API_KEY`	yes	—	Your `np_live_…` / `np_test_…` key.
`NATIVPOST_API_BASE_URL`	no	`https://app.nativpost.com`	Point at staging or a self-hosted instance.
`NATIVPOST_TIMEOUT_MS`	no	`30000`	Per-request timeout in milliseconds.
`NATIVPOST_MCP_DEBUG`	no	`0`	Set to `1` to log requests to stderr.

Troubleshooting

The server exits immediately with a message about NATIVPOST_API_KEY. The key is missing or malformed. The server checks its shape at startup rather than failing on the first tool call, and names the problem — including the two common ones: pasting Bearer np_live_… instead of the raw key, or pasting a key from another service.

Tools return 401 invalid_key. The key was revoked or mistyped. Create a new one in Settings → API keys.

Tools return 403 plan_forbidden. The workspace’s plan doesn’t include API access. See Authentication.

Tools return 402 payment_required. The subscription has lapsed. Billing needs attention before the API will answer.

The client shows no tools. Check that npx is on your PATH and that Node is 18 or newer (node --version). Run npx -y @nativpost/mcp in a terminal with the key set — it should print nativpost-mcp 1.0.0 ready — 20 tools to stderr and then wait for input.

Nothing works and you want detail. Set NATIVPOST_MCP_DEBUG=1 and check your client’s MCP logs. Every request is logged to stderr with its method and URL.