Stonkwatch
Server Details
Real-time ASX stock market data for AI agents. Get live prices, calculate franking credits, retrieve AI-powered announcement summaries, query sentiment analysis, and discover trending stocks. Built on Rust with sub-second response times.
- Status
- Healthy
- Last Tested
- Transport
- Streamable HTTP
- URL
Glama MCP Gateway
Connect through Glama MCP Gateway for full control over tool access and complete visibility into every call.
Full call logging
Every tool call is logged with complete inputs and outputs, so you can debug issues and audit what your agents are doing.
Tool access control
Enable or disable individual tools per connector, so you decide what your agents can and cannot do.
Managed credentials
Glama handles OAuth flows, token storage, and automatic rotation, so credentials never expire on your clients.
Usage analytics
See which tools your agents call, how often, and when, so you can understand usage patterns and catch anomalies.
Tool Definition Quality
Average 3.9/5 across 27 of 27 tools scored. Lowest: 3/5.
Most tools have distinct purposes, but there is some overlap in related areas like attribution (graph, timeline, chart) and sentiment (sentiment, signals, reputation consensus). Descriptions are detailed enough to differentiate them.
All tool names follow a consistent verb_noun snake_case pattern (e.g., get_stock, calculate_franking_credit, list_markets) with no mixing of conventions.
27 tools comprehensively cover the domain of social intelligence for stocks without being excessive. Each tool serves a clear purpose and the count feels appropriate for the server's scope.
The tool set covers the full lifecycle of stock analysis: discovery, search, pricing, sentiment, signals, attribution, coordination, reputation, announcements, narratives, export, and feedback. No obvious gaps for the stated purpose.
Available Tools
28 toolsanalyse_signal_for_use_caseAnalyse Signal For Use CaseRead-onlyInspect
One-shot decision tool. Returns the coordination breakdown, use-case-specific interpretation, and (if raw_sentiment is provided) a coordination-adjusted sentiment score in a single call. Prefer this over chaining get_coordination_breakdown + manual sentiment dampening — the math here matches the canonical filter_sentiment endpoint.
Cost: 1u per call (~$0.01 via x402, deducts 1 from daily quota).
| Name | Required | Description | Default |
|---|---|---|---|
| market | No | ||
| symbol | Yes | ||
| use_case | Yes | ||
| rationale | No | ||
| raw_sentiment | No |
calculate_franking_creditCalculate Franking CreditRead-onlyInspect
Calculate Australian franking (imputation) credits for dividends. Returns franking credit amount, grossed-up dividend, tax payable/refund, and after-tax dividend based on the shareholder's marginal tax rate.
Cost: 1u per call (~$0.01 via x402, deducts 1 from daily quota).
| Name | Required | Description | Default |
|---|---|---|---|
| rationale | No | Optional: one sentence on why you're calling this tool, e.g. 'pre-trade signal check for BHP'. Mined to improve the tool surface when provided. | |
| cash_dividend | Yes | ||
| taxable_income | Yes | ||
| franking_percentage | No | ||
| include_medicare_levy | No |
export_reportExport ReportDestructiveInspect
Persist a composed stock-page report (any combination of stock snapshot, timeline, narrative) as a stable shareable URL. Takes the tool outputs the caller already has and returns a short link other humans or agents can visit to see the same evidence, frozen in time.
Cost: 1u per call (~$0.01 via x402, deducts 1 from daily quota).
| Name | Required | Description | Default |
|---|---|---|---|
| mode | Yes | ||
| market | No | ||
| symbol | Yes | ||
| window | No | ||
| content | Yes | ||
| rationale | No | Optional: one sentence on why you're calling this tool, e.g. 'pre-trade signal check for BHP'. Mined to improve the tool surface when provided. |
get_agent_usageGet Agent UsageRead-onlyInspect
Returns the calling agent's own usage footprint over the last N hours: total calls, error rate, top tools used, and a recent_calls ledger (per-call tool, timestamp, cost_cents, status_code, payment_rail) for cost reconciliation and dispute resolution. Pass caller_id to scope the per-call ledger to your principal; totals and top tools also filter to caller_id when provided.
Cost: 1u per call (~$0.01 via x402, deducts 1 from daily quota).
| Name | Required | Description | Default |
|---|---|---|---|
| caller_id | No | ||
| rationale | No | ||
| window_hours | No |
get_announcement_summaryGet Announcement SummaryRead-onlyInspect
AI-generated summary of a company filing or announcement (ASX disclosures, SEC EDGAR filings) — content, key points, sentiment and financial impact. The AI-SUMMARY facet humans see, as a standalone tool keyed by announcement_id.
Cost: 1u per call (~$0.01 via x402, deducts 1 from daily quota).
| Name | Required | Description | Default |
|---|---|---|---|
| rationale | No | Optional: one sentence on why you're calling this tool, e.g. 'pre-trade signal check for BHP'. Mined to improve the tool surface when provided. | |
| announcement_id | Yes |
get_attribution_chartGet Attribution ChartRead-onlyInspect
Returns an inline 1200x630 SVG price chart for a single attribution: a clean line chart of the ticker's close price across a window around the attribution's created_at, with a vertical marker pinned at the attribution time and the headline_citation text labelled inline. Designed to be embedded by another agent in its own answer (the SVG is small enough to inline). Chart is a price snapshot generated at request time, not a live trading view. Marker placement reflects the attribution's created_at, not the underlying spike's first observation.
Cost: 1u per call (~$0.01 via x402, deducts 1 from daily quota).
| Name | Required | Description | Default |
|---|---|---|---|
| rationale | No | Optional: one sentence on why you're calling this tool, e.g. 'pre-trade signal check for BHP'. Mined to improve the tool surface when provided. | |
| attribution_id | Yes |
get_attribution_graphGet Attribution GraphRead-onlyInspect
Attribution graph nodes and edges for a ticker: spikes, authors, announcements, predicted edges, contributed_to edges. Carries evidence tier counts + the rumour-class disclaimer. Attribution is probabilistic. Evidence tier indicates confidence class; rumour-class and speculative-class signals are not confirmed causal signals — treat them as probabilistic input, not ground truth.
Cost: 1u per call (~$0.01 via x402, deducts 1 from daily quota).
| Name | Required | Description | Default |
|---|---|---|---|
| market | No | ||
| symbol | Yes | ||
| since_ts | No | ||
| rationale | No | Optional: one sentence on why you're calling this tool, e.g. 'pre-trade signal check for BHP'. Mined to improve the tool surface when provided. | |
| min_evidence_tier | No |
get_attribution_timelineGet Attribution TimelineRead-onlyInspect
Score-evolution history for a single attribution: each revision carries the score before/after and the triggering market signals that pushed it. Useful for narrating why the score moved as new evidence (Polymarket odds, X chatter, HotCopper threads, broker notes) arrived. Attribution is probabilistic. Evidence tier indicates confidence class; rumour-class and speculative-class signals are not confirmed causal signals — treat them as probabilistic input, not ground truth.
Cost: 1u per call (~$0.01 via x402, deducts 1 from daily quota).
| Name | Required | Description | Default |
|---|---|---|---|
| adapter | No | ||
| rationale | No | Optional: one sentence on why you're calling this tool, e.g. 'pre-trade signal check for BHP'. Mined to improve the tool surface when provided. | |
| attribution_id | Yes |
get_author_reputationGet Author ReputationRead-onlyInspect
Reputation scorecard and backlinks for a social author. Reputation is time-decayed direction_match rate across attributed spikes. Attribution is probabilistic. Evidence tier indicates confidence class; rumour-class and speculative-class signals are not confirmed causal signals — treat them as probabilistic input, not ground truth.
Cost: 1u per call (~$0.01 via x402, deducts 1 from daily quota).
| Name | Required | Description | Default |
|---|---|---|---|
| handle | Yes | ||
| symbol | No | ||
| platform | Yes | ||
| rationale | No | Optional: one sentence on why you're calling this tool, e.g. 'pre-trade signal check for BHP'. Mined to improve the tool surface when provided. |
get_coordination_breakdownGet Coordination BreakdownRead-onlyInspect
Returns the coordination penalty (0..1) and per-signal breakdown for a ticker, reflecting whether the current social-spike around that symbol looks coordinated (pump-and-dump rings, sock-puppet brigades, paraphrase pumps, cross-platform replays) versus organic discussion.
Before using the breakdown, fetch the spec resource mcp://stonkwatch/specs/coordination once per session — it explains each of the 10 signal classes and the calibrated thresholds. Do NOT guess thresholds; agents that interpret 'penalty > 0.5' without reading the spec routinely misclassify organic spikes as coordinated.
Cost: 1u per call (~$0.01 via x402, deducts 1 from daily quota).
| Name | Required | Description | Default |
|---|---|---|---|
| market | No | ||
| symbol | Yes | ||
| use_case | No | ||
| rationale | No |
get_lead_signalsGet Lead SignalsRead-onlyInspect
Pre-announcement social chatter for a ticker, attributed to platform with lead time. Surfaces cases where retail chatter (e.g. HotCopper) preceded an official announcement — the inbound-beats-outbound signal.
Cost: 1u per call (~$0.01 via x402, deducts 1 from daily quota).
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| market | No | ||
| symbol | Yes | ||
| rationale | No | Optional: one sentence on why you're calling this tool, e.g. 'pre-trade signal check for BHP'. Mined to improve the tool surface when provided. |
get_market_signalsGet Market SignalsRead-onlyInspect
Recent prediction-market signals for a single ticker, sorted by most-recent first. Each row carries provider (polymarket/kalshi/manifold), direction (bullish/bearish/neutral), confidence (0-1), USD volume, evidence URL, and observation timestamp. Use to answer "what are prediction markets pricing for this ticker right now?". Prediction-market signals are derived from public order books (Polymarket Gamma, Kalshi, Manifold). Direction is bullish/bearish/neutral based on market price; confidence reflects distance from 50-50. Volume is indicative of market depth, not certainty. Treat as one input, not as ground truth.
Cost: 1u per call (~$0.01 via x402, deducts 1 from daily quota).
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| ticker | Yes | ||
| adapter | No | ||
| rationale | No | Optional: one sentence on why you're calling this tool, e.g. 'pre-trade signal check for BHP'. Mined to improve the tool surface when provided. |
get_narrativeGet NarrativeRead-onlyInspect
Persona-shaped LLM synthesis for a ticker: trader card, journalist report, or investor thesis. Every sentence cites [sN] markers that map to the sources array; orphan citations fail the response.
Cost: 2u per call (~$0.02 via x402, deducts 2 from daily quota).
| Name | Required | Description | Default |
|---|---|---|---|
| mode | Yes | ||
| format | No | ||
| market | No | ||
| symbol | Yes | ||
| window | No | ||
| rationale | No | Optional: one sentence on why you're calling this tool, e.g. 'pre-trade signal check for BHP'. Mined to improve the tool surface when provided. | |
| max_length | No | ||
| custom_prompt | No |
get_quoteGet QuoteRead-onlyInspect
Market-aware price quote for a single symbol. market='asx' (default) serves Stonkwatch's tracked ASX data with full social intelligence; any other registered exchange serves a live Yahoo Finance quote (price context only — no social intelligence, announcements or attribution for non-ASX listings yet). Supported markets: asx, bme_madrid, borsa_italiana, euronext_amsterdam, euronext_paris, idx, lse, nasdaq, nyse, nzx, six_swiss, xetra ('us' aliases nasdaq).
Cost: 1u per call (~$0.01 via x402, deducts 1 from daily quota).
| Name | Required | Description | Default |
|---|---|---|---|
| market | No | ||
| symbol | Yes | ||
| rationale | No | Optional: one sentence on why you're calling this tool, e.g. 'pre-trade signal check for BHP'. Mined to improve the tool surface when provided. |
get_recent_attributionsGet Recent AttributionsRead-onlyInspect
Firehose of the most recent spike attributions across all tickers, joined with evidence references and the latest revision score. Each row carries a canonical_url (resolves on stonkwatch.app) and a headline_citation (≤140 chars, quote-verbatim sentence). Rows are groupable by event_group and carry exact lead_seconds plus verbatim_quote evidence. Attribution is probabilistic. Evidence tier indicates confidence class; rumour-class and speculative-class signals are not confirmed causal signals — treat them as probabilistic input, not ground truth.
Cost: 1u per call (~$0.01 via x402, deducts 1 from daily quota).
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| offset | No | ||
| adapter | No | ||
| rationale | No | Optional: one sentence on why you're calling this tool, e.g. 'pre-trade signal check for BHP'. Mined to improve the tool surface when provided. |
get_reputation_consensusGet Reputation ConsensusRead-onlyInspect
Per-ticker directional consensus where every comment is weighted by its author's proven track record. Manipulators are excluded and disclosed. Returns score, confidence, author/manipulation counts, and the reputation-ranked underlying comments with per-author backlinks. window: 24h|7d|30d (default 7d).
Cost: 1u per call (~$0.01 via x402, deducts 1 from daily quota).
| Name | Required | Description | Default |
|---|---|---|---|
| market | No | ||
| ticker | Yes | ||
| window | No | ||
| rationale | No | Optional: one sentence on why you're calling this tool, e.g. 'pre-trade signal check for BHP'. Mined to improve the tool surface when provided. |
get_sentimentGet SentimentRead-onlyInspect
Aggregated social sentiment for a ticker over a timeframe — weighted average score, label, post counts, volatility and trend. The synthesised SENTIMENT facet humans see, as a standalone tool.
Cost: 1u per call (~$0.01 via x402, deducts 1 from daily quota).
| Name | Required | Description | Default |
|---|---|---|---|
| market | No | ||
| symbol | Yes | ||
| rationale | No | Optional: one sentence on why you're calling this tool, e.g. 'pre-trade signal check for BHP'. Mined to improve the tool surface when provided. | |
| timeframe | No | ||
| include_external | No |
get_signalsGet SignalsRead-onlyInspect
Raw attributed social posts for a ticker with filters (platform, verified, engagement, sentiment confidence). Breadcrumb endpoint for journalists and traders — not the synthesised view.
Cost: 1u per call (~$0.01 via x402, deducts 1 from daily quota).
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | ||
| limit | No | ||
| since | No | ||
| until | No | ||
| cursor | No | ||
| market | No | ||
| symbol | Yes | ||
| platform | No | ||
| rationale | No | Optional: one sentence on why you're calling this tool, e.g. 'pre-trade signal check for BHP'. Mined to improve the tool surface when provided. | |
| sentiment | No | ||
| verified_only | No | ||
| min_confidence | No | ||
| min_engagement | No |
get_spike_detailGet Spike DetailRead-onlyInspect
Full detail for a single social spike: contributing posts with author + platform + sentiment, attribution rows with lead time and evidence tier. Posts carry body_verbatim (pinned revision). Attribution is probabilistic. Evidence tier indicates confidence class; rumour-class and speculative-class signals are not confirmed causal signals — treat them as probabilistic input, not ground truth.
Cost: 1u per call (~$0.01 via x402, deducts 1 from daily quota).
| Name | Required | Description | Default |
|---|---|---|---|
| spike_id | Yes | ||
| rationale | No | Optional: one sentence on why you're calling this tool, e.g. 'pre-trade signal check for BHP'. Mined to improve the tool surface when provided. |
get_stockGet StockRead-onlyInspect
Composite stock snapshot. One call returns only the slices you request via include[] — price, sentiment, announcements, signals_preview, correlation, related, franking, fundamentals. Mode (trader/journalist/investor) changes defaults only.
Cost: 1u per call (~$0.01 via x402, deducts 1 from daily quota).
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | ||
| symbol | Yes | ||
| window | No | ||
| include | No | ||
| rationale | No | Optional: one sentence on why you're calling this tool, e.g. 'pre-trade signal check for BHP'. Mined to improve the tool surface when provided. | |
| signals_limit | No |
get_timelineGet TimelineRead-onlyInspect
Merged time-ordered events for a ticker: announcements, social signals, and sentiment shifts in one stream. Answers 'did retail know first' — computes lead/lag between social chatter and official filings.
Cost: 1u per call (~$0.01 via x402, deducts 1 from daily quota).
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | ||
| limit | No | ||
| since | No | ||
| types | No | ||
| until | No | ||
| cursor | No | ||
| market | No | ||
| symbol | Yes | ||
| rationale | No | Optional: one sentence on why you're calling this tool, e.g. 'pre-trade signal check for BHP'. Mined to improve the tool surface when provided. | |
| min_importance | No |
get_trendingGet TrendingRead-onlyInspect
Discovery entry point: rank ASX stocks by membrane-potential activity score.
Cost: 1u per call (~$0.01 via x402, deducts 1 from daily quota).
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | ||
| limit | No | ||
| market | No | ||
| window | No | ||
| rationale | No | Optional: one sentence on why you're calling this tool, e.g. 'pre-trade signal check for BHP'. Mined to improve the tool surface when provided. |
list_marketsList MarketsRead-onlyInspect
List every market Stonkwatch can price, with exchange metadata: code (use as get_quote's market argument), display name, country, ISO currency, IANA timezone, regulator, and Yahoo Finance suffix. ASX is served from Stonkwatch's tracked data with full social intelligence; every other exchange returns live Yahoo Finance price quotes (no social intelligence for non-ASX listings yet). Adding a market is a registry entry, so this list is the source of truth for cross-market coverage.
Cost: 1u per call (~$0.01 via x402, deducts 1 from daily quota).
| Name | Required | Description | Default |
|---|---|---|---|
| rationale | No | Optional: one sentence on why you're calling this tool, e.g. 'pre-trade signal check for BHP'. Mined to improve the tool surface when provided. |
purchase_datasetPurchase DatasetDestructiveInspect
Purchase access to an ASX social-intelligence dataset. Grants your API key a batch of pulls for the named product; fetch the data from /api/v1/datasets/{product}/export with your API key.
Cost: 2u per call (~$0.02 via x402, deducts 2 from daily quota).
| Name | Required | Description | Default |
|---|---|---|---|
| product | Yes | dataset slug, e.g. ticker-sentiment-24h | |
| rationale | Yes | why you need this dataset |
render_intelligence_graphRender Intelligence GraphRead-onlyInspect
Returns a self-contained SVG of the evidence graph for a ticker: spikes, authors, announcements, predicted edges, contributed_to edges, with lead-time labels and quote-preview hover text on spike/post nodes. Designed to be embedded directly by another agent (the SVG has no external dependencies). Attribution is probabilistic. Evidence tier indicates confidence class; rumour-class and speculative-class signals are not confirmed causal signals — treat them as probabilistic input, not ground truth.
Cost: 1u per call (~$0.01 via x402, deducts 1 from daily quota).
| Name | Required | Description | Default |
|---|---|---|---|
| market | No | ||
| symbol | Yes | ||
| since_ts | No | ||
| rationale | No | Optional: one sentence on why you're calling this tool, e.g. 'pre-trade signal check for BHP'. Mined to improve the tool surface when provided. | |
| min_evidence_tier | No |
searchSearchRead-onlyInspect
Resolve a query to a canonical stonkwatch ticker entity. Entry point for all session workflows.
Cost: 1u per call (~$0.01 via x402, deducts 1 from daily quota).
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | ||
| limit | No | ||
| query | Yes | ||
| market | No | ||
| rationale | No | Optional: one sentence on why you're calling this tool, e.g. 'pre-trade signal check for BHP'. Mined to improve the tool surface when provided. |
submit_agent_feedbackSubmit Agent FeedbackDestructiveInspect
Tell Stonkwatch when a tool didn't work for you. Call this whenever you were blocked, the response shape was wrong, you needed a parameter that doesn't exist, or the docs were ambiguous. We mine these reports to ship new tools and tighten existing ones. Always include what you were trying to do — not just what failed.
Cost: 1u per call (~$0.01 via x402, deducts 1 from daily quota).
| Name | Required | Description | Default |
|---|---|---|---|
| blocker | Yes | ||
| caller_id | No | ||
| rationale | No | ||
| tool_name | Yes | ||
| attempted_action | Yes | ||
| suggested_improvement | No |
Claim this connector by publishing a /.well-known/glama.json file on your server's domain with the following structure:
{
"$schema": "https://glama.ai/mcp/schemas/connector.json",
"maintainers": [{ "email": "your-email@example.com" }]
}The email address must match the email associated with your Glama account. Once published, Glama will automatically detect and verify the file within a few minutes.
Control your server's listing on Glama, including description and metadata
Access analytics and receive server usage reports
Get monitoring and health status updates for your server
Feature your server to boost visibility and reach more users
For users:
Full audit trail – every tool call is logged with inputs and outputs for compliance and debugging
Granular tool control – enable or disable individual tools per connector to limit what your AI agents can do
Centralized credential management – store and rotate API keys and OAuth tokens in one place
Change alerts – get notified when a connector changes its schema, adds or removes tools, or updates tool definitions, so nothing breaks silently
For server owners:
Proven adoption – public usage metrics on your listing show real-world traction and build trust with prospective users
Tool-level analytics – see which tools are being used most, helping you prioritize development and documentation
Direct user feedback – users can report issues and suggest improvements through the listing, giving you a channel you would not have otherwise
The connector status is unhealthy when Glama is unable to successfully connect to the server. This can happen for several reasons:
The server is experiencing an outage
The URL of the server is wrong
Credentials required to access the server are missing or invalid
If you are the owner of this MCP connector and would like to make modifications to the listing, including providing test credentials for accessing the server, please contact support@glama.ai.
Discussions
No comments yet. Be the first to start the discussion!