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

Getting Started

📄️Quickstart

Make your first Perspective API call in minutes — discover workspaces, find a funnel ID, and fetch contacts.

📄️API Keys

How to obtain, secure, and rotate your Perspective API key from Account Settings.

📄️Authentication

Authenticate Perspective API requests by passing your API key in the x-perspective-api-key header. Covers the auth flow, 401/403 errors, and best practices.

📄️Errors

Understand the Perspective API error response shape and every HTTP status code the API can return.

📄️Pagination

Learn how to use page and limit query params and read the meta object to page through large Perspective API result sets.