UX Report

Integrations · MCP

Ask from the assistant you already use

Cursor, Claude, and ChatGPT pull live AI status, propose the fix, and re-check the answers — on the same server as the product.

Connect an assistant Jump to setup

How it works

One server. Three assistants. Closed loop.

The assistant asks in plain language. UX Report answers with monitored truth, then the path to apply.

Cursor, Claude, or ChatGPT

The assistant your team already has open sends the request.

uxreport MCP

One HTTPS server maps the ask to the Agent API. Same tools in every client.

UX Report

Returns status with asOf, the Opportunity, placement, and a re-check.

Live MCP call · get_ai_status

> user: What's my AI status?

> mcp: invoking get_ai_status

> platform: { asOf: "…", appearance: 42%, cited: 18%, gaps: 11 }

> assistant: Here's the table with asOf — 11 buyer questions still absent.

Setup

Connect the assistant you use

Cursor and Claude Code take a key. Claude and ChatGPT send you back to approve a project.

Open Integrations

In the app: Settings → Integrations. Pick Cursor, Claude, or ChatGPT.

Open Settings → Integrations →

Connect that client

Paste the config for Cursor or Claude Code. For Claude and ChatGPT, approve the project when UX Report opens.

Ask for status

Try: “What's my AI status?” — you should get a table with asOf, not a made-up score.

Cursor

Live

1Sign in to app.ux.report
2Open Settings → Integrations → Cursor
3Create a key for the project
4Paste the config into Cursor’s mcp.json and reload MCP

~/.cursor/mcp.json

{
  "mcpServers": {
    "uxreport": {
      "url": "https://app.ux.report/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Claude Code

Live

For developers

claude mcp add

claude mcp add --transport http --scope user uxreport https://app.ux.report/api/mcp --header "Authorization: Bearer YOUR_API_KEY"

verify

claude mcp list

try

What's my AI status?

Claude

Live

Custom connector

1Open Settings → Integrations → Claude and copy the connector URL
2In Claude, add a custom connector with that URL
3Approve the project when UX Report opens
4Ask for AI status in a new chat

Connector URL

https://app.ux.report/api/mcp

ChatGPT

Live

Developer mode

1In ChatGPT open Settings → Security and login and turn on Developer mode
2Open Settings → Plugins → Browse plugins, press +, and choose Create plugin
3Name it UX Report, paste the server URL, choose OAuth, and create it
4Approve the project when UX Report opens, then pick UX Report from Developer mode in a chat

MCP server URL

https://app.ux.report/api/mcp

You ask

“Run a technical readiness check and show top issues”

Agent returns

Technical health stays in the product today. The agent tools cover status, proposals, placement, apply, and re-check.

Agent tools

Eight tools. One closed loop.

Monitor → decide → place → apply → measure. Server name uxreport, in every assistant.

get_ai_status

Live

AI Visibility table + asOf

propose_solutions

Live

Intent Diagnosis proposal cards

accept_solutions

Live

Create Opportunities on consent

propose_placement

Live

Auto section from Page Model

approve_placement

Live

Approve where it lands

get_apply_payload

Live

WHERE + WHAT for the build

report_apply_status

Live

Write-back from the agent

trigger_recheck

Live

Measure after apply

technical_readiness

Soon

Crawl / read readiness for AI

Supported assistants

Cursor

Remote MCP · API key

Live

Claude Code

Remote MCP · API key

Live

Claude

OAuth connector

Live

ChatGPT

OAuth · Developer mode

Live

Security

You approve the project. Revoke anytime.

Cursor and Claude Code hold a key. Claude and ChatGPT approve access in UX Report.

API keys

Created in Settings → Integrations → Cursor or Claude
Locked to the project you choose
Shown once — store it in the client config
Revoke from the same panel; the next call fails

OAuth approval

Claude and ChatGPT open UX Report to approve a project
ChatGPT does not store the API key in its plugin form
The grant is limited to that project
Revoke the key created for the grant to cut access

Transport

One HTTPS server at app.ux.report/api/mcp
Cursor and Claude Code send a Bearer key
ChatGPT and Claude use OAuth on that same URL
Older Cursor configs can still use the local stdio package

Technical details

Protocol & limits

Protocol

MCP: Streamable HTTP at /api/mcp · server name uxreport
Agent API: HTTPS /api/v1/agent/* behind that server
Auth: Bearer anv_ key, or OAuth 2.1 + PKCE for Claude and ChatGPT
Server name: uxreport

Performance & limits

Cursor / Claude Code: API key in the client config
Claude / ChatGPT: Project approval in UX Report
ChatGPT plan: Developer mode on a paid ChatGPT plan, on the web
Rate limits: Follow your UX Report plan

Frequently asked questions

What AI assistants are supported?

Cursor, Claude Code, Claude, and ChatGPT. They call the same server and the same eight tools.

Where do I connect them?

Settings → Integrations. Cursor and Claude Code need a key. Claude and ChatGPT approve a project.

Does ChatGPT use the Cursor config file?

No. In ChatGPT turn on Developer mode under Settings → Security and login, then add a plugin from Browse plugins with the server URL and OAuth.

Do I need a paid ChatGPT account?

Developer mode is on paid ChatGPT plans on the web. Cursor and Claude Code only need your UX Report key.

Can agencies use this for clients?

Yes. One project per client. Lock the key, or the OAuth approval, to that project.

What data does the server access?

Agent tools for that project: AI status, proposals, Opportunities, placement, apply payload, apply status, and re-check.

How do I revoke access?

Settings → Integrations → the assistant you connected → revoke the key. The next call fails.

Does this replace the UX Report UI?

No. The product stays the record for monitoring, Opportunities, and measurement. Assistants run the same loop.

Put the loop in the assistant you already open

Connect Cursor, Claude, or ChatGPT. Ask for AI status. Approve before anything ships.

Open Settings → Integrations Contact us