MoneySignals Documentation

Give your code — or your AI agent — market signals with a public, audited track record (wins and losses included), ML predictions with honest realized accuracy, and full market context. Available as a REST API and as a one-file MCP server you can connect to any agent in a single step.

Overview

Everything MoneySignals knows is reachable two ways, over the same data:

• REST API — https://api.moneysignals.us. JSON over HTTPS, one API key.
• MCP server — a thin Model Context Protocol wrapper over that API, so Claude Desktop, Claude Code, or any MCP client can call it as tools.

The product is built around one discipline: we walk-forward-test every signal and only call something an “edge” once it clears a statistical precision gate. Today that’s the mechanical ETF pullback rule, plus a secular-dip study that cleared its pre-registered gate in September 2026 (published as research, not yet an alert feed); the LLM event signals are graded live in the open (their aggregate currently sits near coin-flip on hit rate), and always-on per-ticker ML is near coin-flip out-of-sample. The API surfaces all three — and is honest about which is which (see Where the edge is).

Quick start

1. Verify the track record — no key needed

The audited track record is public, so you can check it before signing up:

# live win rate, avg return, resolved-call count for the event signals
curl https://api.moneysignals.us/track-record

2. Get a free API key — it comes with the free email signup

Join the free daily email and confirm your address — your API key arrives in the welcome email, no card required. It unlocks the ML predictions and every market-context endpoint. Pass it as the X-API-Key header (or Authorization: Bearer <key>, whichever your client prefers):

curl -H "X-API-Key: at_sk_your_key" \
  https://api.moneysignals.us/api/v1/market/regime

Paid plans (from $29/mo) add the event signals (graded live, wins and losses included) plus alt-data and higher limits — every paid plan includes both the daily email and API access.

3. Or connect an agent in one command — hosted MCP, nothing to install

claude mcp add --transport http moneysignals https://api.moneysignals.us/mcp \
  --header "X-API-Key: at_sk_your_key"

Then ask your agent: “What’s the market regime, and how accurate were MoneySignals’ recent predictions?” — see Connect via MCP.

Authentication, tiers & limits

• Header: X-API-Key: at_sk_… — or Authorization: Bearer at_sk_… — on every request except the public ones below.
• Public (no key): GET /track-record and GET /demo/snapshot — so you can connect and verify immediately.
• Free key: included with the free email signup — confirm your email and the key is in the welcome email. Lost it? Sign up again with the same address and confirm: the old key is revoked and a fresh one is emailed to you.
• Your key’s status: GET /api/v1/account/me works on every key and returns your tier, rate limits, and total usage. (Detailed 30-day analytics via GET /api/v1/account/usage is API Pro.) Every response carries X-RateLimit-Remaining and X-RateLimit-Reset headers (plus …-Day variants) so you can pace yourself; a 429 adds Retry-After and means slow down or upgrade.
• Errors come back as JSON — {"detail": "…", "code": "…"}. The detail is a sentence written for you and gets reworded; code is stable, so branch on that: missing_api_key, invalid_api_key, api_key_deactivated, api_key_expired, tier_required, and rate_limited_minute vs rate_limited_day — pause a moment, or come back tomorrow. The 401 and 403 messages point you to pricing; the closed list is the ErrorCode enum in the OpenAPI spec.

Keys report their internal tier name (api_starter / api_pro) in GET /api/v1/account/me — existing API Starter ($49) and API Pro ($199) keys keep working unchanged and map to Premium and Professional.

Connect an AI agent (MCP)

Any MCP client (Claude Code, Claude Desktop, your own agent) gets all of MoneySignals as callable tools — no SDK to learn, no endpoints to wire up. Two ways to connect, same 31 tools either way: the hosted server (recommended — one command, nothing to install) or a downloadable one-file stdio server.

Hosted — one command, nothing to install

claude mcp add --transport http moneysignals https://api.moneysignals.us/mcp \
  --header "X-API-Key: at_sk_your_key"

No Python, no download, always the latest tools. Your key rides on the connection as an HTTP header — leave the --header off to connect keyless and try get_track_record first. Any client that speaks MCP Streamable HTTP works the same way: point it at https://api.moneysignals.us/mcp and send X-API-Key (or Authorization: Bearer) on each request. Building your own agent? It’s plain JSON-RPC:

curl -X POST https://api.moneysignals.us/mcp \
  -H "Content-Type: application/json" -H "X-API-Key: at_sk_your_key" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"get_market_regime","arguments":{}}}'

Or run it locally (stdio)

Prefer a local process — or your client can’t send custom headers (Claude Desktop’s config, for one)? Download the one-file server:

pip install "mcp>=1.2" httpx
# download the one-file server (always the latest)
curl -O https://api.moneysignals.us/mcp/server.py

Claude Code — local stdio variant

claude mcp add moneysignals \
  --env MONEYSIGNALS_API_KEY=at_sk_your_key \
  -- python /path/to/server.py

Claude Desktop — config

Settings → Developer → Edit Config, then add:

{
  "mcpServers": {
    "moneysignals": {
      "command": "python",
      "args": ["/path/to/server.py"],
      "env": { "MONEYSIGNALS_API_KEY": "at_sk_your_key" }
    }
  }
}

Restart the client. Without a key, only get_track_record works — enough to confirm the connection. The free key unlocks predictions, market context and the ETF pullback signal; paid keys add the event signals. Override the base URL with MONEYSIGNALS_API_BASE if needed.

The 31 tools

Open the intelligence workspace for the human view. Agent evidence tools read the same global observations; they cannot access private portfolios. Source configuration does not imply collected coverage: check status, source clocks and stale flags.

no key public. free key works with the free key from the email signup. premium / professional need a paid plan (from $29/mo — email + API together).

Automated execution — pair with a broker

MCP servers don’t call each other; they’re both tools your agent uses. So automated investing is: connect both the MoneySignals MCP (for what to trade) and a broker MCP — e.g. Robinhood’s Agentic Trading MCP — (for execution), and let the agent orchestrate.

Two tools make this turnkey:

• get_daily_brief — the whole gated decision in one call: is the regime safe, what are the top picks, is a macro event imminent.
• get_trade_plan — the picks already shaped as {action, ticker, conviction} so each item maps straight onto a broker order.

{
  "count": 2,
  "plan": [
    {"action":"buy", "ticker":"SMH", "conviction":0.61, "type_win_rate":0.76},
    {"action":"sell_or_short", "ticker":"QPQ", "conviction":0.48}
  ],
  "disclaimer": "Model-derived suggestions — NOT financial advice."
}

Example agent prompt:

REST API reference

Base URL https://api.moneysignals.us. All endpoints below are prefixed /api/v1 unless noted, return JSON, and need the X-API-Key header. Try them live in the interactive API reference (or ReDoc).

Signals

Premium and up (key tier api_starter) — except /track-record (public) and /signals/etf-pullback + /signals/youtube-scoreboard (free key).

Predictions

Works with the free key (/predictions/batch is Professional).

Market context

Works with the free key.

Global evidence is also available at GET /intelligence/events and GET /intelligence/status under the same /api/v1 prefix. Event filters: source=usgs|eia|worldmonitor|osiris, category=earthquake|energy_inventory, limit=1..50 (default 20), and the returned cursor (maximum 1,000 characters). A registered provider may be unavailable or not configured. Unknown coverage is not a quiet-world conclusion.

Social, alt-data & account

Social is Professional; alternative data is Premium and up. /account/me works on any key (/account/usage is Professional).

Where the edge is

We did the walk-forward homework so you don’t over-trust the wrong thing:

Conviction ranks signals by a sample-size-shrunk type win-rate × the signal’s own confidence, so a lucky small-sample type can’t top the list.

Honesty & limits

• The track record is built from resolved signals (their stated horizon has elapsed) — no live-signal leakage, no cherry-picking. First-order types are included so the numbers aren’t flattering by selection.
• Aggregate returns are direction-signed P&L — a correct bearish call counts positive, so winning shorts aren’t averaged away. Ledger rows show the raw price move; direction + outcome carry the sign there.
• Win rates on small samples are noisy and can decay; treat any single number as evidence, not a guarantee.
• Some feeds lag (e.g. options-derived PCR carries a stale flag); the API tells you when.
• Nothing here is financial advice. Predictions and signals are automated, uncertain, and frequently wrong. See the Terms.