# io.github.sailorpepe/undesirables-mcp-server (remote · mcp.the-undesirables.com)

Conformal TCG risk forecasts + AI card grading, x402 pay-per-call oracle, on-chain soul agents.

- Trust score: 53/100 (low)
- Change this week: +2
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- remote · `mcp.the-undesirables.com`: 53/100 (this document), [markdown](https://verifymcp.io/servers/sailorpepe-undesirables-mcp-server/mcp.md), [page](https://verifymcp.io/servers/sailorpepe-undesirables-mcp-server/mcp)
- pypi · `undesirables-mcp-server`: 21/100, [markdown](https://verifymcp.io/servers/sailorpepe-undesirables-mcp-server/undesirables-mcp-server.md), [page](https://verifymcp.io/servers/sailorpepe-undesirables-mcp-server/undesirables-mcp-server)

## Channel facts

- Endpoint: `https://mcp.the-undesirables.com`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.1.10`

## 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-08-03.

- **Endpoint Security**: 46/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation not fully verified: no authorisation is required to call this server, and 12 tool(s) never declared a destructiveHint. The MCP spec treats an absent hint as destructive by default, so we cannot call this surface safe.
  - HTTPS not yet verified: we couldn't determine whether a plaintext access path exists.
  - 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**: 46/100
  - AI-judged instruction clarity (fair).
  - Context-footprint check failed: tool/resource definitions use about 2539 tokens (~211/item across 12 items; 12 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 27/100
  - Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 67/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 0% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add --transport http sailorpepe-undesirables-mcp-server https://mcp.the-undesirables.com/
```

### Codex

```toml
[mcp_servers.sailorpepe-undesirables-mcp-server]
url = "https://mcp.the-undesirables.com/"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "sailorpepe-undesirables-mcp-server": {
      "type": "remote",
      "url": "https://mcp.the-undesirables.com/",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add sailorpepe-undesirables-mcp-server --url https://mcp.the-undesirables.com/ --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  sailorpepe-undesirables-mcp-server:
    url: "https://mcp.the-undesirables.com/"
```

### Other

```json
{
  "mcpServers": {
    "sailorpepe-undesirables-mcp-server": {
      "type": "http",
      "url": "https://mcp.the-undesirables.com/"
    }
  }
}
```

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-08-02 (score 53, +1)

No change was recorded against any check on this day. Stability & Change Management went from 20 to 23. That category is still filling its 30-day observation window: 6 days of observed history at the previous scan, 7 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-31 (score 52, +1)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 51, −1)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-29 (score 52, +1)

No change was recorded against any check on this day. Stability & Change Management went from 7 to 10. That category is still filling its 30-day observation window: 2 days of observed history at the previous scan, 3 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-27 (score 51, +1)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-26 (score 50)

First indexed and scored.

## MCP tools (12)

### `search_tcg_products` (~307 tokens)

Search 449K+ TCG products across 25+ card games.
Returns card names and IDs, plus current market prices.
FREE — no payment required.

Use this when: a user asks about a specific card, wants to find cards,
or needs current pricing for any trading card game product.

HOW TO SEARCH (card name AND set name are both searchable):
  • Card name alone casts the widest net: "Charizard", "Black Lotus".
  • Add the SET to pin down a printing: "Base Set Charizard" returns the
    Base Set, Base Set 2 and Shadowless Charizards as separate entries.
    This matters — printings of the "same" card differ wildly in value.
  • Every result carries a "set" field. Use it to choose, then pass that
    result's product_id to the other tools (card_forecast, grade_or_not,
    simulate_price) — exact, and avoids re-searching.
  • Do NOT include rarity or condition words: "Holo", "1st Edition",
    "Shadowless", "PSA 10" are not indexed and will sink an otherwise-good
    query. "Base Set Charizard Holo" → drop "Holo".
  • Got nothing? Remove the rarity words first, then fall back to the plain
    card name.

Input parameters:

- `game` (string)
- `limit` (integer)
- `query` (string, required)

### `market_snapshot` (~157 tokens)

Daily TCG market snapshot with top movers, biggest gainers/losers,
and volume leaders across all 25 supported card games.

PAID: $0.025 USDC per call (x402 — USDC on Base or Solana, or USDG on
Robinhood Chain). Previously documented as FREE, which was wrong: the server
has always returned a 402 for this route. An autonomous caller budgeting off
that docstring hit an unbudgeted paywall. (External audit 2026-07-30, BUG-2.)

Use this when: a user asks "what's trending in the card market?" or
"what cards are going up/down in value?"

Input parameters:

- `game` (string)

### `grade_card` (~250 tokens)

AI-grade a trading card image using a 3-stage pipeline:
(1) Qwen Vision LLM analyzes corners, edges, surface defects
(2) OpenCV measures exact centering ratios programmatically
(3) BGS professional capping algorithm adjusts the final grade

Returns PSA/Beckett-calibrated subgrades and an overall condition score.
Also includes a free ROI verdict (should you grade this card?).

PAID: $0.10 per call via x402. THREE rails are accepted, not just Base:
  \- USDC on Base            (eip155:8453)
  \- USDC on Solana          (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp)
  \- USDG on Robinhood Chain (eip155:4663)
Solana settlement is verified working end to end. (Audit 2026-07-30, BUG-12.)

Use this when: a user has a card image and wants to know what grade
it would receive from PSA or Beckett.

Input parameters:

- `game` (string)
- `image_url` (string, required)

### `grade_or_not` (~139 tokens)

Answers: "Should I grade this card? Will I make money?"

Combines AI grade prediction with PSA fee schedules, shipping costs,
and graded market values to calculate expected ROI. Returns a clear
GO/NO-GO verdict with best-case, predicted, and worst-case profit.

PAID: $0.10 USDC per call.

Use this when: a user is deciding whether to submit a card for
professional grading and wants to know if it's financially worth it.

Input parameters:

- `card_name` (string, required)
- `predicted_grade` (number)
- `raw_price` (number)
- `service_tier` (string)

### `simulate_price` (~187 tokens)

Predict future trading card value. The default model is the
conformal-calibrated risk forecast (deterministic drift + regime-aware
split-conformal bands, honest VaR/CVaR, plus Safe-Hold & Momentum letter
grades). Monte Carlo GBM and Merton jump-diffusion are available opt-in
via model="gbm" or model="merton".

Returns full forecast percentiles (5th–95th), model parameters,
and confidence intervals with complete mathematical transparency.

PAID: $0.015 USDC per call.

Use this when: a user wants to know "what will this card be worth
in 3 months?" or wants price trajectory predictions.

Input parameters:

- `card_name` (string, required)
- `current_price` (number, required)
- `days` (integer)
- `model` (string)
- `simulations` (integer)

### `card_forecast` (~273 tokens)

Get the conformal-calibrated 30-day price forecast AND letter grades for a
single card in ONE free call. Pass either a card_name (resolved to the best
match) or a TCGplayer product_id.

FREE — no payment required. Returns an agent-complete object:
  price, as_of, regime, point (median 30d), move_pct, prob_up,
  band50_pct, band90_pct, var95_pct, var99_pct, low90, high90,
  safe_hold grade (A+..F), momentum grade (A+..F or "NA" on a drift spike),
  drift_spike, image_url, card_url, and a one-line plain_english read
  (e.g. "~12% chance it's below $Y in 30 days; Safe-Hold B, Momentum A").

Use this when a user asks "is this card a safe hold?", "what's the 30-day
outlook?", "how risky is X?", or wants a quick grade on a card.
Tip: GET /api/v1/forecast (no args) returns the free board of the top ~200
cards if the user wants a market overview.

Input parameters:

- `card_name` (string)
- `product_id` (integer)

### `trending_cards` (~215 tokens)

Top trading cards by PRICE VELOCITY (drift), highest absolute movement first.

NOTE (corrected 2026-07-30): this previously claimed "30-day sales volume".
Sales volume and view counts are NOT in the dataset and the API itself now
explicitly disclaims them — see `ranked_by` in the response.

Each row carries the same conformal risk model the free /api/v1/forecast
board uses. Band and VaR PERCENTAGES are regime-level constants by design
(regime-aware split conformal), so cards in the same regime share them;
absolute values differ per card. Do not read it as a per-card fit.
Covers all 25+ supported TCG games.

PAID: $0.025 USDC per call.

Use this when: a user asks "what cards are hot right now?" or
"what's selling the most?"

Input parameters:

- `game` (string)
- `limit` (integer)
- `min_price` (number)

### `optimize_portfolio` (~134 tokens)

Optimize a trading card portfolio using Markowitz mean-variance
analysis with Merton jump-diffusion Monte Carlo simulations.

Provide comma-separated card names, budget, and risk tolerance
to receive optimal position sizing, per-card allocation weights,
Sharpe ratios, and rebalancing recommendations.

PAID: $0.50 USDC per call.

Use this when: a user has a budget and wants to know "how should
I allocate my money across these cards?"

Input parameters:

- `budget` (number)
- `cards` (string, required)
- `days` (integer)
- `risk_tolerance` (string)

### `recommend_workflow` (~118 tokens)

Describe your goal in natural language and get a recommended sequence
of TCG Oracle API calls to accomplish it.

FREE — no payment required.

Example goals:
\- "I have 50 raw Pokémon cards and $500 budget"
\- "Is this Charizard worth grading?"
\- "Find me undervalued cards to flip"
\- "Predict the price of a Black Lotus in 90 days"

Use this when: you're not sure which tool to call first, or need
a multi-step workflow recommendation.

Input parameters:

- `goal` (string, required)

### `check_accuracy` (~73 tokens)

View TCG Oracle's public prediction accuracy dashboard.
Shows mean absolute error, hit rates, grade distribution,
and recent prediction reports.

FREE — no payment required.

Use this when: a user asks "how accurate is the grading AI?"
or wants to verify the model's track record.

Input parameters:

- `game` (string)

### `souls_in_wallet` (~478 tokens)

Show every Undesirable soul a wallet holds, with each soul's public
prediction track record and its most recent calls.
FREE — no payment, no signature, no wallet connection required.

Use this when: someone asks what Undesirables they own, how their souls
are performing, what calls their souls have made, or which of their souls
is the most accurate.

HOW IT WORKS
  • Ownership is read from Ethereum mainnet (ERC-721
    0xA893648A701C03B14bF2FB767B72b2C55ed5c17A). Only the minted souls
    1-273 have public records.
  • Nothing here is private, so you can look up ANY address — the caller
    does not have to prove they own it. Ask the user for their address.
  • Each minted soul locks 3 card predictions weekly, chosen deterministically
    from its on-chain personality traits. The oracle scores them 30 days later
    against real market prices.

WHAT YOU GET BACK
  • souls[]        — per soul: rating (A+..F / UNRATED), matured, hits,
                     hit_rate, brier, open_calls, and recent_calls with each
                     call's outcome (hit / miss / push)
  • wallet_totals  — combined open + matured calls and overall hit rate
  • best_soul      — the holder's most accurate soul, once any have matured

HOLDERS WITH SEVERAL SOULS: this is a roster. Offer to compare them, or to
speak as a specific one — each has different traits and its own record.

IMPORTANT — ratings mature on a schedule. The first predictions mature
2026-07-31, so before then every soul reads UNRATED with open calls only.
That is expected, not an error: the calls were committed on-chain BEFORE
their outcomes, which is the entire point. Say so rather than implying the
soul has no history.

Args:
    address: 0x-prefixed EVM address to look up.
    calls: recent scored calls to include per soul (0-12, default 5).

Input parameters:

- `address` (string, required)
- `calls` (integer)

### `soul_calls` (~128 tokens)

Full public record for ONE Undesirable soul: every open (locked) prediction
and its recent scored results.
FREE — no payment required.

Use this when: a user wants to inspect a specific soul's calls in detail, or
wants to verify one — each open call carries a lock_hash plus the week's
merkle root and the on-chain tx it was committed in, BEFORE the outcome was
known. That is what makes the record checkable rather than claimed.

Args:
    token_id: minted soul, 1-273.

Input parameters:

- `token_id` (integer, required)

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/sailorpepe-undesirables-mcp-server/mcp#diagnostics

## Score history

- 2026-08-03: 53
- 2026-08-02: 53
- 2026-08-01: 52
- 2026-07-31: 52
- 2026-07-30: 51
- 2026-07-29: 52
- 2026-07-28: 51
- 2026-07-27: 51
- 2026-07-26: 50

## Links

- Remote endpoint: https://mcp.the-undesirables.com/
- Repository: https://github.com/sailorpepe/undesirables-mcp-server
- Website: https://oracle.the-undesirables.com/
- Changelog RSS feed: https://verifymcp.io/servers/sailorpepe-undesirables-mcp-server/mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/sailorpepe-undesirables-mcp-server/mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/sailorpepe-undesirables-mcp-server/mcp
