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
perception_get_marketfreeweight 1Bitcoin price, market cap, chain reference metrics and the Perception Index.
Price, block height and the Index, for a report dateline.
perception_guidefreeweight 1In-agent onboarding and workflow templates.
What can Perception do, and how should I use it?
perception_daily_radarfreeweight 2Daily briefing: anomalies, sentiment shifts, emerging narratives.
What changed overnight?
perception_get_indexfreeweight 1The Perception Index with drivers and velocity.
What is the Index today, and what is driving it?
perception_search_mentionsperceptionweight 1Search thousands of sources with sentiment, outlet, language and region filters.
Every mention of Coinbase last week, negative only.
perception_get_trendsperceptionweight 2AI-extracted narrative trends with signal strength.
Which narratives are gaining signal strength right now?
perception_get_sentimentperceptionweight 1Historical sentiment by day and by outlet.
How has sentiment toward stablecoins moved this quarter?
perception_get_categoriesperceptionweight 1Trend category distribution.
Which categories dominate coverage this month?
perception_search_companiesperceptionweight 2Entity-recognition company search, more accurate than keyword matching.
Which companies keep coming up alongside custody?
perception_compare_entitiesperceptionweight 2Two to five companies side by side: volume, sentiment, sources.
Compare Coinbase, Kraken and Gemini on volume and sentiment.
perception_narrative_momentumperceptionweight 1Whether a topic is accelerating, steady or fading.
Is tokenization accelerating or fading?
perception_top_mentionsperceptionweight 1Top entities or topics by mention count for a date range or outlet.
Who was mentioned most at DAS NYC?
perception_cohort_sentimentperceptionweight 1Sentiment split by speaker role: execs, devs, analysts, media.
Are developers more bearish than executives here?
perception_get_evadometerperceptionweight 1Earnings-call directness scores.
Which management teams dodge the most questions?
perception_get_entity_profileperceptionweight 3Full entity picture: coverage, analyst view, trends, relationships, timeline.
Give me everything on Circle.
perception_media_radarperceptionweight 1Outlet-specific coverage analysis.
How does Bloomberg cover this differently from CoinDesk?
perception_get_analyst_ratingsintelligenceweight 1Analyst consensus, price targets and rating changes for covered tickers.
What is the analyst consensus on MSTR?
perception_search_regulatoryintelligenceweight 1Regulatory filings, enforcement actions and policy documents by agency and jurisdiction.
What has the SEC published on custody this year?
perception_get_articleintelligenceweight 3Full text of a single article.
Pull the full text of this piece.
perception_save_researchintelligenceweight 1Save a research note with findings and topics (90-day retention).
Save this finding so I can come back to it.
perception_recall_researchintelligenceweight 1Retrieve saved research notes by recency or topic.
What did I find on this last month?
perception_scenario_analysisintelligenceweight 3Test a hypothetical against historical analogues: sentiment arcs, narrative half-life.
If an ETF were rejected, how has coverage behaved before?
perception_get_insider_activityintelligenceweight 1SEC Form 4 insider trades with cluster alerts.
Are insiders at this company buying or selling?
perception_get_earnings_intelligenceintelligenceweight 1Earnings-call analysis: management tone, directness, notable quotes.
How direct was management on the last call?
perception_get_intelligence_digestintelligenceweight 3Cross-signal briefing fusing analyst actions, sentiment, earnings and regulatory moves.
One briefing across every signal today.
perception_search_voicesintelligenceweight 1Search reporters and commentators by beat, outlet and coverage pattern.
Which reporters cover mining regulation?
perception_get_brains_corpusintelligenceweight 2Bulk corpus access for a tracked voice or entity.
Everything this executive has posted.
perception_get_divergencesintelligenceweight 1Where narrative and capital disagree.
Where does the narrative disagree with the money?
perception_get_capital_exposureintelligenceweight 113F holdings, treasury positions and beneficial ownership for an entity.
Who holds this stock, and how has that changed?
perception_get_hiringintelligenceweight 1Open roles and hiring posture for a company from its public ATS board.
Is Kraken hiring right now, and for what?
perception_hiring_leaderboardintelligenceweight 1Companies ranked by open roles across the tracked universe, by sector and function.
Which crypto companies are hiring the most right now?
Allowances
- Free: 4 tools, 5 credits/day. A four-tool evaluation layer for orientation and market context.
- Perception: 16 tools, 20 credits/day. The complete core research workflow, including entity profiles and media radar.
- Intelligence: 31 tools, 100 credits/day. Every tool, and every call costs exactly 1 credit at any size.