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

📄️CLI Overview

The perspective command-line tool for the REST API — query funnels, contacts and metrics from your terminal, scripts, CI, or coding agents.

📄️CLI Authentication

Authenticate the Perspective CLI with an API key — store it with perspective auth login, or pass it through an environment variable in CI.

📄️Command Reference

Every perspective CLI command — workspaces, funnels, contacts, metrics, auth and the agent skill — with flags and examples.

📄️Using the CLI with AI Agents

Give coding agents like Claude Code reliable access to Perspective through the CLI and its bundled Agent Skill (SKILL.md).