Skip to main content

Choose your AI tool:

Antigravity

{
  "mcpServers": {
    "perspective-docs": {
      "serverUrl": "https://api.perspective.co/mcp"
    }
  }
}

Claude CodeCLI
claude mcp add perspective-docs https://api.perspective.co/mcp --transport http --scope user
CodexCLI
codex mcp add --url https://api.perspective.co/mcp perspective-docs

Cursor

{
  "mcpServers": {
    "perspective-docs": {
      "type": "http",
      "url": "https://api.perspective.co/mcp"
    }
  }
}

Cursor Agent

{
  "mcpServers": {
    "perspective-docs": {
      "type": "http",
      "url": "https://api.perspective.co/mcp"
    }
  }
}

Gemini CLICLI
gemini mcp add --transport http perspective-docs https://api.perspective.co/mcp

Goose

{
  "extensions": {
    "perspective-docs": {
      "enabled": true,
      "name": "perspective-docs",
      "type": "streamable_http",
      "uri": "https://api.perspective.co/mcp",
      "envs": {},
      "env_keys": [],
      "headers": {},
      "description": "",
      "timeout": 300,
      "bundled": null,
      "available_tools": []
    }
  }
}

JetBrains AI Assistant
```
{
  "mcpServers": {
    "perspective-docs": {
      "type": "http",
      "url": "https://api.perspective.co/mcp"
    }
  }
}
```
Configuration must be pasted into Settings → Tools → AI Assistant → Model Context Protocol → Add → As JSON. Direct file writing is not supported due to version-specific XML storage.

OpenCode

{
  "mcp": {
    "perspective-docs": {
      "type": "remote",
      "url": "https://api.perspective.co/mcp"
    }
  }
}

Visual Studio CodeCLI
code --add-mcp '{"name":"perspective-docs","type":"http","url":"https://api.perspective.co/mcp"}'

Windsurf

{
  "mcpServers": {
    "perspective-docs": {
      "serverUrl": "https://api.perspective.co/mcp"
    }
  }
}

Supports both stdio and native HTTP connections

Learn more about MCP

CLI Authentication

The CLI authenticates with the same API key as the REST API. Create one under Settings → API Keys in the Perspective app (Admins only — see API Keys). The key's permissions (crm:read, crm:write, metrics:read) decide which commands work.

Store your API key

perspective auth login

At a terminal, the CLI prompts for the key without echoing it. In a script, pipe it in instead, so it doesn't end up in your shell history:

printf %s "$PERSPECTIVE_API_KEY" | perspective auth login

The CLI validates the key with one read request before storing it.

Check and clear the key

perspective auth status   # whether a key is configured and where it comes from; no network calls
perspective auth logout   # delete the stored key

auth status never prints the key in full; it is masked.

CI and automation

Skip the stored file and pass the key through the environment:

export PERSPECTIVE_API_KEY=…

Precedence, highest first: the --api-key flag, the PERSPECTIVE_API_KEY environment variable, the stored key.

Where the key is stored

~/.config/perspective/credentials.json (or $XDG_CONFIG_HOME/perspective/, or $PERSPECTIVE_CONFIG_DIR), readable only by your user (mode 0600). Treat it like a password.

Store your API key
Check and clear the key
CI and automation
Where the key is stored