MCP reference
Endpoint: https://mcp.perception.to/mcp. OAuth clients sign in through Perception. Developer clients can use a bearer token from Settings > Integrations.
Tools
32 registered tools: 31 metered research tools plus the unmetered taxonomy helper. Each accepted metered request uses one included daily call. Prepaid usage follows the weights below.
perception_get_marketall tiersprepaid weight 1Bitcoin price, market cap, chain reference metrics and the Perception Index.
Price, block height and the Index, for a report dateline.
perception_guideall tiersprepaid weight 1In-agent onboarding and workflow templates.
What can Perception do, and how should I use it?
perception_get_subject_taxonomyall tiersunmeteredCanonical subject labels and accepted aliases for precise query construction.
Which subject labels should I use for a custody research query?
perception_daily_radarall tiersprepaid weight 2Daily briefing: anomalies, sentiment shifts, emerging narratives.
What changed overnight?
perception_get_indexall tiersprepaid weight 1The five-index Perception portfolio with current readings, confidence, components and optional history.
Show me every Perception proprietary index and what each says now.
perception_search_mentionsall tiersprepaid weight 1Search thousands of sources with sentiment, outlet, language and region filters.
Every mention of Coinbase last week, negative only.
perception_get_trendsall tiersprepaid weight 2AI-extracted narrative trends with signal strength.
Which narratives are gaining signal strength right now?
perception_get_sentimentall tiersprepaid weight 1Historical sentiment by day and by outlet.
How has sentiment toward stablecoins moved this quarter?
perception_get_categoriesall tiersprepaid weight 1Trend category distribution.
Which categories dominate coverage this month?
perception_search_companiesall tiersprepaid weight 2Entity-recognition company search, more accurate than keyword matching.
Which companies keep coming up alongside custody?
perception_compare_entitiesall tiersprepaid weight 2Two to five companies side by side: volume, sentiment, sources.
Compare Coinbase, Kraken and Gemini on volume and sentiment.
perception_narrative_momentumall tiersprepaid weight 1Whether a topic is accelerating, steady or fading.
Is tokenization accelerating or fading?
perception_top_mentionsall tiersprepaid weight 1Top entities or topics by mention count for a date range or outlet.
Who was mentioned most at DAS NYC?
perception_cohort_sentimentall tiersprepaid weight 1Sentiment split by speaker role: execs, devs, analysts, media.
Are developers more bearish than executives here?
perception_get_evadometerall tiersprepaid weight 1Earnings-call directness scores.
Which management teams dodge the most questions?
perception_get_entity_profileall tiersprepaid weight 3Full entity picture: coverage, analyst view, trends, relationships, timeline.
Give me everything on Circle.
perception_media_radarall tiersprepaid weight 1Outlet-specific coverage analysis.
How does Bloomberg cover this differently from CoinDesk?
perception_get_analyst_ratingsall tiersprepaid weight 1Analyst consensus, price targets and rating changes for covered tickers.
What is the analyst consensus on MSTR?
perception_search_regulatoryall tiersprepaid weight 1Regulatory filings, enforcement actions and policy documents by agency and jurisdiction.
What has the SEC published on custody this year?
perception_get_articleall tiersprepaid weight 3Full text of a single article.
Pull the full text of this piece.
perception_save_researchall tiersprepaid weight 1Save a research note with findings and topics (90-day retention).
Save this finding so I can come back to it.
perception_recall_researchall tiersprepaid weight 1Retrieve saved research notes by recency or topic.
What did I find on this last month?
perception_scenario_analysisall tiersprepaid weight 3Test a hypothetical against historical analogues: sentiment arcs, narrative half-life.
If an ETF were rejected, how has coverage behaved before?
perception_get_insider_activityall tiersprepaid weight 1SEC Form 4 insider trades with cluster alerts.
Are insiders at this company buying or selling?
perception_get_earnings_intelligenceall tiersprepaid weight 1Earnings-call analysis: management tone, directness, notable quotes.
How direct was management on the last call?
perception_get_intelligence_digestall tiersprepaid weight 3Cross-signal briefing fusing analyst actions, sentiment, earnings and regulatory moves.
One briefing across every signal today.
perception_search_voicesall tiersprepaid weight 1Search earnings transcripts, conferences, and podcasts for keywords, with snippets and timestamped occurrences.
What have speakers said about stablecoins in podcasts and earnings calls?
perception_get_brains_corpusall tiersprepaid weight 2Bulk corpus access for a tracked voice or entity.
Everything this executive has posted.
perception_get_divergencesall tiersprepaid weight 1Where narrative and capital disagree.
Where does the narrative disagree with the money?
perception_get_capital_exposureall tiersprepaid weight 113F holdings, treasury positions and beneficial ownership for an entity.
Who holds this stock, and how has that changed?
perception_get_hiringall tiersprepaid weight 1Open roles and hiring posture for a company from its public ATS board.
Is Kraken hiring right now, and for what?
perception_hiring_leaderboardall tiersprepaid weight 1Companies ranked by open roles across the tracked universe, by sector and function.
Which crypto companies are hiring the most right now?
Allowances
- Free: 31 metered research tools, 5 included requests/day. All 31 research tools, 5 calls a day, no card required. Taxonomy discovery is unmetered.
- Perception: 31 metered research tools, 20 included requests/day. All 31 research tools, 20 included requests a day, plus the Perception app. Taxonomy discovery is unmetered.
- Intelligence: 31 metered research tools, 100 included requests/day. All 31 research tools, and each accepted metered request uses one included call at any size. Taxonomy discovery is unmetered.