Perception

{
  "name": "Perception",
  "version": "0.3",
  "description": "Narrative intelligence for the digital asset industry. Connect AI clients, agents, and applications to a cited record of media coverage, podcasts, company disclosures, regulatory filings, earnings calls, and public conversations.",
  "url": "https://mcp.perception.to/mcp",
  "protocols": [
    "mcp",
    "rest"
  ],
  "defaultInputModes": [
    "application/json"
  ],
  "defaultOutputModes": [
    "application/json"
  ],
  "supportsAuthenticatedExtendedCard": true,
  "capabilities": {
    "search": true,
    "analysis": true,
    "real_time_data": true,
    "structured_output": true,
    "recurring_workflows": true,
    "tool_count": 35,
    "commercial_tool_count": 33,
    "unmetered_tools": [
      "perception_get_subject_taxonomy",
      "perception_get_usage"
    ]
  },
  "commercial_model": {
    "schema_version": 3,
    "version": "2026-09-21-weighted-v2",
    "signup_url": "https://app.perception.to/auth/sign-up?source=pricing-metered&plan=metered",
    "calculation": {
      "formula": "min(tool_base_credits + ceil(requested_results / 25), 10)",
      "tool_base_credits": [
        1,
        2,
        3
      ],
      "result_block_size": 25,
      "maximum_credits_per_call": 10
    },
    "access": [
      {
        "id": "free",
        "subscription_required": false,
        "tool_count": 33,
        "included_credits": 5,
        "credit_window": "utc-day",
        "credit_accounting": "weighted"
      },
      {
        "id": "registered_metered",
        "subscription_required": false,
        "tool_count": 33,
        "credit_accounting": "weighted",
        "price_usd_per_credit": 0.05,
        "daily_paid_credit_limit": 20,
        "saved_card_required": true,
        "activation_required": true
      },
      {
        "id": "perception",
        "monthly_price_usd": 249,
        "tool_count": 33,
        "included_credits": 1000,
        "credit_window": "subscription-month",
        "credit_accounting": "weighted",
        "overage_price_usd_per_credit": 0.025,
        "overage_cap_options_usd": [
          25,
          50
        ]
      },
      {
        "id": "intelligence",
        "monthly_price_usd": 499,
        "tool_count": 33,
        "included_credits": 8000,
        "credit_window": "subscription-month",
        "credit_accounting": "weighted",
        "overage_price_usd_per_credit": 0.025,
        "overage_cap_options_usd": [
          25,
          50,
          100,
          250
        ]
      },
      {
        "id": "x402",
        "account_required": false,
        "credit_accounting": "weighted",
        "price_usd_per_credit": 0.1,
        "tool_count": 33
      }
    ],
    "settlement": {
      "reservation": "reserve the estimated weighted cost before execution",
      "successful_calls": "commit the reservation, including legitimate zero-result responses",
      "failed_calls": "release failures, validation failures, timeouts, and idempotent retries",
      "funding_order": [
        "included",
        "grandfathered-prepaid",
        "opted-in-overage"
      ]
    }
  },
  "authentication": {
    "schemes": [
      "oauth2",
      "bearer"
    ],
    "oauth2": {
      "authorization_url": "https://mcp.perception.to/authorize",
      "token_url": "https://mcp.perception.to/token",
      "registration_url": "https://mcp.perception.to/register"
    }
  },
  "replay_protection": {
    "automatic_window_seconds": 120,
    "explicit_window_seconds": 86400,
    "explicit_headers": [
      "Idempotency-Key",
      "X-Request-Id"
    ],
    "static_connector_header_supported": false,
    "json_rpc_id_reuse": "A repeated id and exact body inside 120 seconds is treated as transport redelivery."
  },
  "skills": [
    {
      "id": "agent_workflow_setup",
      "name": "Agent Workflow Setup",
      "description": "Generate a recurring Reputation Manager, Partnership Scout, or Weekly Executive Brief specification for Codex or Claude Code",
      "tags": [
        "agents",
        "automation",
        "codex",
        "claude-code"
      ],
      "examples": [
        "Configure a Reputation Manager",
        "Build a weekly executive brief that runs every Monday"
      ]
    },
    {
      "id": "article_search",
      "name": "Article Search",
      "description": "Search thousands of digital asset sources by keyword with sentiment and outlet filters",
      "tags": [
        "search",
        "sentiment",
        "media"
      ],
      "examples": [
        "Search for Bitcoin ETF articles from the last 7 days",
        "Find negative coverage about Coinbase"
      ]
    },
    {
      "id": "company_intelligence",
      "name": "Company Intelligence",
      "description": "Entity-recognition search for company-specific media coverage, sentiment, and narrative associations",
      "tags": [
        "companies",
        "entities",
        "due-diligence"
      ],
      "examples": [
        "How is Strategy being covered this month?",
        "Compare media sentiment for Coinbase vs Kraken"
      ]
    },
    {
      "id": "company_signals",
      "name": "Company Signals",
      "description": "Track hiring posture, fundraising announcements, capital exposure, partnerships, and other cited company events",
      "tags": [
        "hiring",
        "fundraising",
        "capital",
        "business-development"
      ],
      "examples": [
        "Which digital asset companies are hiring the most right now?",
        "Which companies announced funding rounds this month?",
        "Who holds this public digital asset company?"
      ]
    },
    {
      "id": "narrative_trends",
      "name": "Narrative Trends",
      "description": "AI-extracted narrative trends with signal strength and business implications",
      "tags": [
        "trends",
        "narratives",
        "signals"
      ],
      "examples": [
        "What narratives are gaining momentum?",
        "Show me regulatory trends"
      ]
    },
    {
      "id": "sentiment_analysis",
      "name": "Sentiment Analysis",
      "description": "Historical sentiment metrics over configurable date ranges",
      "tags": [
        "sentiment",
        "historical",
        "analytics"
      ],
      "examples": [
        "What was Bitcoin sentiment last week?",
        "Show me 90-day sentiment trend"
      ]
    },
    {
      "id": "market_data",
      "name": "Market Data",
      "description": "Bitcoin price, market cap, volume, and Fear & Greed Index",
      "tags": [
        "market",
        "price",
        "fear-greed"
      ],
      "examples": [
        "What is the current Fear & Greed Index?",
        "Bitcoin market overview"
      ]
    },
    {
      "id": "analyst_ratings",
      "name": "Analyst Ratings",
      "description": "Wall Street analyst consensus, price targets, and upgrades/downgrades for 70 crypto-related stocks",
      "tags": [
        "analyst",
        "ratings",
        "price-targets",
        "wall-street"
      ],
      "examples": [
        "What are analysts saying about COIN?",
        "Show me recent crypto stock upgrades"
      ]
    },
    {
      "id": "entity_profile",
      "name": "Entity Profile",
      "description": "Complete entity intelligence profile with coverage volume, analyst data, trends, relationships, and timeline",
      "tags": [
        "entity",
        "profile",
        "intelligence",
        "360-view"
      ],
      "examples": [
        "Give me a full profile on BlackRock in crypto",
        "Entity intelligence for Tether"
      ]
    },
    {
      "id": "media_radar",
      "name": "Media Radar",
      "description": "Outlet-specific coverage analysis with article count, sentiment breakdown, and articles",
      "tags": [
        "outlets",
        "media",
        "coverage"
      ],
      "examples": [
        "How is Bloomberg covering Bitcoin?",
        "Compare CoinDesk vs The Block coverage"
      ]
    },
    {
      "id": "full_text",
      "name": "Full-Text Retrieval",
      "description": "Complete article content retrieval for in-depth analysis",
      "tags": [
        "articles",
        "full-text",
        "content"
      ],
      "examples": [
        "Get the full text of this article"
      ]
    }
  ],
  "provider": {
    "organization": "Perception",
    "url": "https://perception.to",
    "contact": "hello@perception.to"
  },
  "payments": [
    {
      "protocol": "x402",
      "description": "Pay per call for full-text REST feed data on Base mainnet. MCP access uses the separate OAuth/Bearer endpoint.",
      "endpoint": "https://api.perception.to/feed",
      "method": "GET",
      "scope": "full-text REST feed only",
      "x402_version": 1,
      "network": "base",
      "network_name": "Base mainnet",
      "asset": "USDC",
      "asset_contract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "pay_to": "0xA89dac7b70e04c880974b02758Bd8fde14280013",
      "max_amount_required": "1000000",
      "max_timeout_seconds": 120,
      "price": "$0.10 per weighted credit",
      "spec": "https://www.x402.org"
    }
  ],
  "unavailable_payments": [
    {
      "protocol": "l402",
      "status": "unavailable",
      "description": "This Lightning payment rail remains inactive while invoice creation is under repair."
    }
  ],
  "agent_workflows": [
    {
      "id": "reputation-manager",
      "version": "1.0.0",
      "name": "Reputation Manager",
      "summary": "Tracks harmful coverage, competitor wins, narrative spread, and the attention level that needs a response.",
      "estimated_calls_per_run": 4,
      "supported_clients": [
        "codex",
        "claude-code"
      ],
      "delivery_channels": [
        "codex",
        "slack",
        "email"
      ],
      "recommended_interval_minutes": 360,
      "setup_url": "https://app.perception.to/app/agent-workflows?workflow=reputation-manager"
    },
    {
      "id": "partnership-scout",
      "version": "1.0.0",
      "name": "Partnership Scout",
      "summary": "Finds companies showing a current partnership signal and turns repeated coverage into one qualified opportunity.",
      "estimated_calls_per_run": 5,
      "supported_clients": [
        "codex",
        "claude-code"
      ],
      "delivery_channels": [
        "codex",
        "slack",
        "email"
      ],
      "recommended_interval_minutes": 1440,
      "setup_url": "https://app.perception.to/app/agent-workflows?workflow=partnership-scout"
    },
    {
      "id": "weekly-executive-brief",
      "version": "1.0.0",
      "name": "Weekly Executive Brief",
      "summary": "Delivers a fixed-format weekly briefing with market, company, risk, regulatory, and evidence sections.",
      "estimated_calls_per_run": 7,
      "supported_clients": [
        "codex",
        "claude-code"
      ],
      "delivery_channels": [
        "codex",
        "slack",
        "email"
      ],
      "recommended_interval_minutes": 10080,
      "setup_url": "https://app.perception.to/app/agent-workflows?workflow=weekly-executive-brief"
    }
  ],
  "acquisition": {
    "public_trial": false,
    "free_weighted_credits_per_utc_day": 5
  },
  "tool_count": 35,
  "commercial_tool_count": 33,
  "unmetered_tools": [
    "perception_get_subject_taxonomy",
    "perception_get_usage"
  ]
}