Beta: The Pierview MCP server is in active development. Exact tool names,
parameters, and response formats may evolve over time.
Overview
The Pierview MCP server lets AI tools like Claude Desktop and Claude Code query your AI visibility data directly. Ask questions about your citations, key metrics, and competitor mentions without leaving your workflow. Authentication is secured using OAuth with OIDC with PKCE.Prerequisites
- A Pierview account with an active subscription
Setup
- Claude Desktop
- Claude Code
- Agent SDK
Open Claude Desktop settings
Go to Claude Desktop > Customize > Connectors > + > Add custom connector.
Add the MCP server
Add the following details as prompted:
- Name: Pierview
- Remote MCP Server URL: https://mcp.pierview.ai

Available Tools
All data tools accept an optionalorganizationId parameter. If omitted, your default organization is used. Call list_organizations first to see your available organizations.
list_organizations
List all organizations you have access to. Call this first to discover available organization IDs.
Parameters: None
Returns: Array of organizations with organizationId, organizationName, workspaceName, and role.
get_key_metrics
Get mention rate, average ranking, and share of voice for your organization (14-day rolling average).
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
organizationId | number | No | Organization to query (defaults to your default org) |
| Field | Type | Description |
|---|---|---|
mention_rate | number | null | Percentage of LLM responses that mention your organization |
average_ranking | number | null | Mean ranking position when mentioned (lower is better) |
share_of_voice | number | null | Your mentions as a percentage of all competitor mentions |
get_citations_by_host
Get top cited hosts with week-over-week metrics and LLM breakdown.
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
limit | number | No | Max hosts to return (default 50, max 500) |
endDate | string | No | End date for WoW comparison in YYYY-MM-DD format |
organizationId | number | No | Organization to query |
get_citations_by_page
Get top cited pages with week-over-week metrics and LLM breakdown.
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
limit | number | No | Max pages to return (default 50, max 500) |
organizationId | number | No | Organization to query |
get_visibility_timeseries
Get visibility trends over time by competitor.
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
webSearch | boolean | No | Filter by web search enabled responses (default true) |
organizationId | number | No | Organization to query |
get_competitor_llm_breakdown
Get which LLMs mention which competitors and at what percentage over the last 14 days.
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
webSearch | boolean | No | Filter by web search enabled responses (default true) |
organizationId | number | No | Organization to query |
API Keys
API keys let you authenticate with the Pierview MCP server using a Bearer token instead of OAuth. This is useful for server-side integrations, CI/CD pipelines, or any environment where browser-based OAuth isn’t practical. Keys are scoped to your organization and can be created, viewed, and revoked from the Pierview dashboard.Creating an API Key
Open Configuration
Go to your Pierview dashboard and select the API Keys tab.
Create a new key
Click Create API Key, enter a descriptive name (e.g. “Production MCP” or “CI Pipeline”), then click Create.
Using Your API Key
Pass the key as a Bearer token in theAuthorization header when connecting to the MCP server.
- Claude Code
- Claude Desktop
- Cursor
Revoking a Key
To revoke an API key, go to the API Keys tab in Configuration and click the trash icon next to the key you want to disable. Revoked keys are immediately rejected by the server.Security
- API keys are hashed before storage — Pierview never stores your plaintext key
- Each key is scoped to a single organization
- Revoked keys cannot be re-activated; create a new key if needed
- Rotate keys periodically as a best practice
Example Queries
Once connected, you can ask your AI tool questions like:- “What are my top cited pages this week?”
- “What is my current mention rate and share of voice?”
- “How has my visibility changed over the last two weeks?”
- “Which LLMs mention my competitors the most?”
- “Show me citation trends for my different organizations”