Skip to content
Documentation

MCP reference

Find a tool by the question you want to answer. Every plan has access to the complete tool catalog.

Server address
https://mcp.perception.to/mcp

OAuth clients sign in through Perception. Developer clients can use a bearer token from Settings > Integrations.

Connect your AI

perception_get_market

1 base credit

Bitcoin price, market cap, chain reference metrics and the Perception Index.

Try asking: Price, block height and the Index, for a report dateline.

Available on every plan

perception_guide

1 base credit

In-agent onboarding and workflow templates.

Try asking: What can Perception do, and how should I use it?

Available on every plan

perception_get_subject_taxonomy

Unmetered

Canonical subject labels and accepted aliases for precise query construction.

Try asking: Which subject labels should I use for a custody research query?

Available on every plan

perception_get_usage

Unmetered

Current weighted-credit usage, funding state, reset time, overage status, and credential totals.

Try asking: How many credits are left before this workflow continues?

Available on every plan

perception_daily_radar

2 base credits

Daily briefing: anomalies, sentiment shifts, emerging narratives, and material company announcements.

Try asking: What changed overnight?

Available on every plan

perception_get_index

1 base credit

Perception Index, Narrative Dominance, Narrative Cost Basis, Narrative Consensus and Narrative Reach, with current readings, confidence, components and optional history.

Try asking: Show me every Perception proprietary index and what each says now.

Available on every plan

perception_search_mentions

1 base credit

Search thousands of sources for mentions, fundraising announcements, capital raises, partnerships, and other company signals.

Try asking: Which digital asset companies announced funding rounds this month?

Available on every plan

perception_get_trends

2 base credits

AI-extracted narrative trends with signal strength.

Try asking: Which narratives are gaining signal strength right now?

Available on every plan

perception_get_sentiment

1 base credit

Historical sentiment by day and by outlet.

Try asking: How has sentiment toward stablecoins moved this quarter?

Available on every plan

perception_get_categories

1 base credit

Trend category distribution.

Try asking: Which categories dominate mentions this month?

Available on every plan

perception_search_companies

2 base credits

Entity-recognition company search, more accurate than keyword matching.

Try asking: Which companies keep coming up alongside custody?

Available on every plan

perception_compare_entities

2 base credits

Two to five companies side by side: volume, sentiment, sources.

Try asking: Compare Coinbase, Kraken and Gemini on volume and sentiment.

Available on every plan

perception_narrative_momentum

1 base credit

Whether a topic is accelerating, steady or fading.

Try asking: Is tokenization accelerating or fading?

Available on every plan

perception_top_mentions

1 base credit

Top entities or topics by mention count for a date range or outlet.

Try asking: Who was mentioned most at DAS NYC?

Available on every plan

perception_cohort_sentiment

1 base credit

Sentiment by speaker role: executives, developers, analysts, and reporters.

Try asking: Are developers more bearish than executives here?

Available on every plan

perception_get_evadometer

1 base credit

Earnings-call directness scores.

Try asking: Which management teams dodge the most questions?

Available on every plan

perception_get_entity_profile

3 base credits

Full entity picture: mentions, analyst view, trends, relationships, timeline.

Try asking: Give me everything on Circle.

Available on every plan

perception_media_radar

1 base credit

Mention analysis by publication.

Try asking: How does Bloomberg cover this differently from CoinDesk?

Available on every plan

perception_get_analyst_ratings

1 base credit

Analyst consensus, price targets and rating changes for covered tickers.

Try asking: What is the analyst consensus on MSTR?

Available on every plan

perception_search_regulatory

1 base credit

Regulatory filings, enforcement actions and policy documents by agency and jurisdiction.

Try asking: What has the SEC published on custody this year?

Available on every plan

perception_get_article

3 base credits

Full text of a single article.

Try asking: Pull the full text of this piece.

Available on every plan

perception_save_research

1 base credit

Save a research note with findings and topics (90-day retention).

Try asking: Save this finding so I can come back to it.

Available on every plan

perception_recall_research

1 base credit

Retrieve saved research notes by recency or topic.

Try asking: What did I find on this last month?

Available on every plan

perception_scenario_analysis

3 base credits

Test a hypothetical against historical analogues: sentiment arcs, narrative half-life.

Try asking: If an ETF were rejected, how have mentions changed before?

Available on every plan

perception_get_insider_activity

1 base credit

SEC Form 4 insider trades with cluster alerts.

Try asking: Are insiders at this company buying or selling?

Available on every plan

perception_get_earnings_intelligence

1 base credit

Earnings-call analysis: management tone, directness, notable quotes.

Try asking: How direct was management on the last call?

Available on every plan

perception_get_intelligence_digest

3 base credits

Cross-signal briefing fusing analyst actions, sentiment, earnings and regulatory moves.

Try asking: One briefing across every signal today.

Available on every plan

perception_search_voices

1 base credit

Search earnings transcripts, conferences, and podcasts for keywords, with snippets and timestamped occurrences.

Try asking: What have speakers said about stablecoins in podcasts and earnings calls?

Available on every plan

perception_get_brains_corpus

2 base credits

Source records for a tracked person or company.

Try asking: Everything this executive has posted.

Available on every plan

perception_get_divergences

1 base credit

Where narrative and capital disagree.

Try asking: Where does the narrative disagree with the money?

Available on every plan

perception_get_capital_exposure

1 base credit

13F holdings, treasury positions and beneficial ownership for an entity.

Try asking: Who holds this stock, and how has that changed?

Available on every plan

perception_get_hiring

1 base credit

Open roles and hiring posture for a company from its public ATS board.

Try asking: Is Kraken hiring right now, and for what?

Available on every plan

perception_hiring_leaderboard

1 base credit

Companies ranked by open roles across the tracked universe, by sector and function.

Try asking: Which crypto companies are hiring the most right now?

Available on every plan

perception_get_institutional_allocators

1 base credit

Named institutional allocator book: pensions, endowments, sovereign funds, insurers, and family offices — bitcoin-paper history, category news, and the crypto-related 13F sleeve.

Try asking: What are pensions and endowments doing in Bitcoin?

Available on every plan

perception_get_market_signals

1 base credit

Editorial headline tape of partnerships, fundraising, and people moves, with corpus counts.

Try asking: What partnerships and raises hit the press this month?

Available on every plan
Read credit rules and the complete reference