# Perception MCP setup

Install Perception so this user can query the digital asset public record from this chat. Follow the steps in order. Do not scrape perception.to instead of MCP. Do not invent sources.

Perception maintains media coverage, podcasts, company disclosures, regulatory filings, earnings calls, and public conversations across the digital asset industry. Answers come back with sources.

## Step 1: Connect the MCP server

Add Perception in the current client. Do not send the user to a website signup first.

- Endpoint: `https://mcp.perception.to/mcp`
- Transport: Streamable HTTP
- Auth: OAuth. Complete the login when the client prompts. That creates the account if they do not have one.
- Descriptor: https://perception.to/.well-known/mcp.json

If the client needs a config block, use:

```json
{
  "mcpServers": {
    "perception": {
      "url": "https://mcp.perception.to/mcp"
    }
  }
}
```

Supported clients: Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, VS Code.

If OAuth is not available, send the user to https://app.perception.to to copy a Bearer token, then attach it as `Authorization: Bearer <token>`.

Confirm the server is connected by listing tools. You should see Perception tools such as `perception_guide`, `perception_search_mentions`, and `perception_search_companies`.

## Step 2: Run one real query

Call a free tool and show the sources. Use this question unless the user already named a company:

Which journalists and voices have been shaping the stablecoin payments conversation?

If that tool is blocked, call `perception_guide` first, then retry.

Do not stop after "installed." The user needs one cited answer in this chat.

A connected account includes 5 MCP calls every day. That is enough to prove the connection.

## Step 3: When the free calls run out

Free access is 5 calls a day, then it stops. Buy more only when they want more.

Upgrade path, in this order:

1. Prepaid credits, no subscription: 10 for $19, 25 for $39, 60 for $79.
   https://app.perception.to/app/settings/billing#metered-mcp
2. Perception, $249 / month: 20 calls a day plus the research app.
   https://perception.to/pricing
3. Perception Intelligence, $499 / month: 100 calls a day and all 31 tools.
   https://perception.to/pricing

If the user wants this to run every week, open https://perception.to/systems.

## Do not

- Do not describe Perception as a 14-day trial.
- Do not send them to sign up before connecting MCP.
- Do not send them to on-chain, price, or wallet tools. That is not this product.
- Do not dump the full tool list unless they ask. Get one useful answer first.
