# xyz.groundtruths/groundtruth (remote · api.groundtruths.xyz)

Sealed launch outcomes and creator records for Solana and Robinhood Chain. Every figure carries N.

- Trust score: 65/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-09-20

## Components

- remote · `api.groundtruths.xyz`: 65/100 (this document), [markdown](https://verifymcp.io/servers/xyz-groundtruths-groundtruth/api.md), [page](https://verifymcp.io/servers/xyz-groundtruths-groundtruth/api)

## Channel facts

- Endpoint: `https://api.groundtruths.xyz/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.0.0`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-09-20.

- **Endpoint Security**: 63/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - No authorisation is required to call this server. Every tool declares its destructiveHint and none is destructive, so open access doesn't expose one.
  - HTTPS enforcement could not be verified: the plaintext port answered with HTTP 405, which proves neither a plaintext path nor enforcement.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 73/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 1648 tokens (~149/item across 11 items; 11 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 3/100
  - Stability observed for 1 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 98/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 95% of tool parameters carry a description.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 11 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 12 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 60/100
  - Spec-recency check failed: implements MCP spec 2025-06-18; the latest is 2026-07-28.

## Install

### How do I install the xyz.groundtruths/groundtruth MCP server?

xyz.groundtruths/groundtruth is a hosted endpoint at https://api.groundtruths.xyz/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add --transport http xyz-groundtruths-groundtruth 'https://api.groundtruths.xyz/mcp'
```

### Cursor

```json
{
  "mcpServers": {
    "xyz-groundtruths-groundtruth": {
      "url": "https://api.groundtruths.xyz/mcp"
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "xyz-groundtruths-groundtruth": {
      "type": "http",
      "url": "https://api.groundtruths.xyz/mcp"
    }
  }
}
```

### Codex

```toml
[mcp_servers.xyz-groundtruths-groundtruth]
url = "https://api.groundtruths.xyz/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "xyz-groundtruths-groundtruth": {
      "type": "remote",
      "url": "https://api.groundtruths.xyz/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add xyz-groundtruths-groundtruth --url 'https://api.groundtruths.xyz/mcp' --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  xyz-groundtruths-groundtruth:
    url: "https://api.groundtruths.xyz/mcp"
```

### Netclaw

```json
{
  "McpServers": {
    "xyz-groundtruths-groundtruth": {
      "Transport": "http",
      "Url": "https://api.groundtruths.xyz/mcp"
    }
  }
}
```

### Vellum

```bash
assistant mcp add xyz-groundtruths-groundtruth -t streamable-http -u 'https://api.groundtruths.xyz/mcp'
```

### Other

```json
{
  "mcpServers": {
    "xyz-groundtruths-groundtruth": {
      "type": "http",
      "url": "https://api.groundtruths.xyz/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-09-20 (score 65, 0)

- [functional improvement] Stability: unverified → 0.03

### 2026-09-19 (score 65)

First indexed and scored.

## MCP tools (11)

### `groundtruth_scan_coin` (~139 tokens)

Look up one token and return what GROUNDTRUTH recorded about it: the outcome label (rugged, died, graduated, survived, or no outcome recorded), liquidity and market-cap figures, holder counts, and the record of the wallet that launched it. Accepts a Solana mint or a Robinhood Chain 0x contract address. This is the same read the public site performs when someone pastes a contract address.

Input parameters:

- `address` (string, required): A Solana mint (base58) or a Robinhood Chain contract address (0x...). Example: So11111111111111111111111111111111111111112

### `groundtruth_screen_creator` (~217 tokens)

Given one creator address, return every wallet that was early in that creator's launches: the role each played (creator, operator_pool, repeat_buyer, one_off), how many of this creator's launches it was early in versus how many it was early in anywhere, and that wallet operator's own rug rate. Also returns the apparent-versus-true collapse: how many wallets LOOK independent versus how many distinct actors they actually are, after merging wallets with near-identical launch histories. Rates come with the chain baseline, because a rate without its baseline is not a finding. This is the analysis no other source produces.

Input parameters:

- `chain` (string): Which chain the creator launched on.
- `creator` (string, required): Creator address. base58 for Solana, 0x... for Robinhood Chain.
- `limit` (integer): Maximum wallet rows to return. The response reports wallets_truncated when it caps.
- `role` (string): Optional filter. Omit for all roles. operator_pool is the row that matters most.

### `groundtruth_screen_batch` (~176 tokens)

Screen up to 200 creator addresses in ONE call and get one compact row each: launches, rug rate, the chain baseline, the multiple of that baseline, wallets tied, and the apparent-versus-true operator collapse. Use this instead of calling groundtruth_screen_creator in a loop. known_bad is true only when the creator is in the published set, has at least 5 resolved launches, and rugs at 1.5 times the chain baseline or worse -- a bare rug rate is noise, the multiple is a decision. known_bad is null, NEVER false, for a creator we have no record of: absence is not innocence.

Input parameters:

- `chain` (string): Which chain these creators launched on.
- `creators` (array, required): Creator addresses. base58 for Solana, 0x... for Robinhood Chain.

### `groundtruth_creator_flag` (~151 tokens)

One creator in, one small answer out: is this creator known bad, with the rug rate, the chain baseline and the multiple that justifies the verdict. The cheapest call on this server -- use it when all you need is the decision rather than the wallet list. known_bad is null, never false, for a creator we have no record of. The data behind it is a batch export, so a creator who launched in the last hour is not in it yet; every response carries the timestamp it was generated.

Input parameters:

- `chain` (string): Which chain the creator launched on.
- `creator` (string, required): Creator address. base58 for Solana, 0x... for Robinhood Chain.

### `groundtruth_scoreboard` (~50 tokens)

Return the public accuracy scoreboard: how many forward calls GROUNDTRUTH has made, how many have resolved, and how those resolved. Use this to judge how much weight to give the other tools.

### `groundtruth_census_figures` (~79 tokens)

Return the corpus-level figures the site publishes: launches captured per chain, how many resolved, and the share that rugged, died, survived or graduated, with the generation timestamp. This is market data GROUNDTRUTH has captured, not exhaustive coverage from a start date -- use it for baselines, not for totals of all activity.

### `groundtruth_time_to_rug` (~188 tokens)

How fast coins in a given risk band actually rugged: median seconds from GROUNDTRUTH first seeing the curve to the rug, with p25 and p75, for one chain, band and window. Use it to answer "how long would I have had". The denominator is calls that rugged in the window AND carry a rug time, and it travels in the answer. Below 30 such calls the percentiles are null and enough_data is false -- say "not enough resolved calls to state a time" rather than quoting a number. Omit every argument to get the whole table in one call.

Input parameters:

- `band` (string): the band GROUNDTRUTH assigned at the time of the call
- `chain` (string): solana (pump.fun) or rh (Robinhood Chain)
- `window` (string): the resolution window; defaults to 24h

### `groundtruth_creator_replay` (~234 tokens)

What $100 would have done across a creator's last N resolved launches. Returns two rows. held_to_end is a MEASUREMENT: the recorded multiple at the end of each launch, with rugged launches counted as zero because the liquidity was pulled. clock_upper_bound is a CEILING, not a prediction: it uses the recorded PEAK multiple and only where the peak arrived at or before the band p25, because the published record carries the peak and the final multiple, not the path between them. Say "at most" when you quote it. Launches with no recorded multiple are excluded from BOTH the stake and the return, so the two describe the same set -- quote computed_for and of, never just the total. Solana only today: the Robinhood outcome record carries no peak multiple, so neither row can be computed there.

Input parameters:

- `creator` (string, required): the creator wallet (base58)
- `n` (integer): how many of the most recent resolved launches, 1-12, default 10
- `usd` (number): the stake per launch in dollars, default 100

### `groundtruth_seal_call` (~161 tokens)

Seal a verdict BEFORE the outcome exists, so it can be scored later. This is the honesty mechanism: the row is hash-chained to the previous one under your API key, so a verdict cannot be edited or removed after the coin resolves. Seal every call you make, including the ones you are confident about -- a scorecard built only from remembered wins is not a scorecard. Returns the row hash and sequence number.

Input parameters:

- `band` (string): the band you are calling it
- `ca` (string, required): the coin address you are calling
- `chain` (string)
- `note` (string): optional, up to 200 characters
- `rule_id` (string): the rule_id behind the band, from the scan

### `groundtruth_scorecard` (~112 tokens)

How often calls sealed under this API key were right. Groups them by band and by what the coin actually did, resolved from the same record the card reads. A call whose coin has not resolved counts as PENDING, never as a win -- report pending alongside resolved, because the denominator is the point. Also returns whether the hash chain is intact; if it is not, say so rather than quoting the numbers.

Input parameters:

- `limit` (integer): rows to read, 1-500, default 200

### `groundtruth_autopsy_index` (~58 tokens)

List the dated autopsies GROUNDTRUTH has published. Each is a writeup of one launch and what happened to it. Returns the available days; fetch a specific one from the public site at /autopsy/<day>.

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/xyz-groundtruths-groundtruth/api#diagnostics

## Score history

- 2026-09-20: 65
- 2026-09-19: 65

## Common questions

### What is the xyz.groundtruths/groundtruth MCP server?

xyz.groundtruths/groundtruth is an MCP server listed in the public MCP registry as xyz.groundtruths/groundtruth. Sealed launch outcomes and creator records for Solana and Robinhood Chain. Every figure carries N. This page covers its hosted endpoint (https://api.groundtruths.xyz/mcp).

### Is the xyz.groundtruths/groundtruth MCP server safe to use?

xyz.groundtruths/groundtruth scores 65 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the xyz.groundtruths/groundtruth MCP server expose?

xyz.groundtruths/groundtruth exposes 11 tools: groundtruth_scan_coin, groundtruth_screen_creator, groundtruth_screen_batch, groundtruth_creator_flag, groundtruth_scoreboard, and 6 more. Their descriptions and schemas cost roughly 1,565 tokens of context every time the server is loaded.

### Does the xyz.groundtruths/groundtruth MCP server require authentication?

No. We connected to xyz.groundtruths/groundtruth without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.

### Is the xyz.groundtruths/groundtruth MCP server still maintained?

xyz.groundtruths/groundtruth is still listed as active in the MCP registry. We last reached this channel on 20 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

## Links

- Remote endpoint: https://api.groundtruths.xyz/mcp
- Repository: https://github.com/groundtruths/groundtruth-mcp
- Website: https://groundtruths.xyz/methodology
- Changelog RSS feed: https://verifymcp.io/servers/xyz-groundtruths-groundtruth/api.xml
- Changelog JSON feed: https://verifymcp.io/servers/xyz-groundtruths-groundtruth/api.json
- HTML version of this page: https://verifymcp.io/servers/xyz-groundtruths-groundtruth/api