Wicked MCP

Official30 tools

by choaticpixels · TypeScript

Whole Wicked suite for agents: market data, SEC filings, wallet checks, risk, identity, memory.

MCP Server: io.github.choaticpixels/wicked-mcp

The MCP server io.github.choaticpixels/wicked-mcp provides functionality described as “Trading data, agent reputation, tool reliability, Know-Your-Agent identity,” with a “x402-native” attribute. Its purpose centers on supplying and evaluating those categories of information within an MCP context.

🛠️ Key Features

Trading data
Agent reputation
Tool reliability
Know-Your-Agent identity
x402-native

🚀 Use Cases

Exchanging or referencing trading data
Assessing reputation signals for agents
Checking reliability of tools
Performing identity-related “Know-Your-Agent” checks

⚡ Developer Benefits

Centralizes trading data, reputation, tool reliability, and identity signals under one server entrypoint
Aligns outputs with an explicitly stated “x402-native” implementation detail

⚠️ Limitations

No additional details are provided about specific MCP tools, endpoints, authentication, or data formats in the available source.

Topics

agent-identityai-agentsbaseknow-your-agentmcpmcp-servermodel-context-protocolreputationusdcx402

Captured live from the server via tools/list.

wickedapi_price

Get the current price for a symbol (crypto or stock) from WickedAPI. Args: symbol: e.g. BTC, ETH, SUI, NVDA, SPY. asset_class: "stock" or "crypto" — required for symbols outside the curated list, optional otherwise.

Parameters2

symbol	string	required
asset_class	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "title": "Symbol",
      "type": "string"
    },
    "asset_class": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Asset Class"
    }
  },
  "required": [
    "symbol"
  ],
  "title": "wickedapi_priceArguments"
}

wickedapi_momentum

Get WickedAPI's momentum score for a symbol. Args: symbol: One of BTC, ETH, SOL, SUI, NVDA, IBIT, COIN, QQQ, TQQQ, DIA. timeframe: One of 15m, 1h, 4h, 1D, 1W. Defaults to 1h.

Parameters2

symbol	string	required
timeframe	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "title": "Symbol",
      "type": "string"
    },
    "timeframe": {
      "default": "1h",
      "title": "Timeframe",
      "type": "string"
    }
  },
  "required": [
    "symbol"
  ],
  "title": "wickedapi_momentumArguments"
}

wickedapi_funding_oi

Get perpetual-futures funding rate and open interest for a crypto symbol. Args: symbol: Base crypto symbol, e.g. BTC, ETH, SOL — mapped to the <SYMBOL>USDT perpetual on Binance/Bybit.

Parameters1

symbol

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "title": "Symbol",
      "type": "string"
    }
  },
  "required": [
    "symbol"
  ],
  "title": "wickedapi_funding_oiArguments"
}

reputation_status

Get an agent's current reputation: tier, active/unbonding stake, reputation score, slash count, founding-member badge. Returns http_status 404 for a wallet that has never registered — treat that the same as tier "unranked", not an error. Args: wallet: The agent's 0x wallet address on Base.

Parameters1

wallet

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "title": "Wallet",
      "type": "string"
    }
  },
  "required": [
    "wallet"
  ],
  "title": "reputation_statusArguments"
}

reputation_statement

Get an agent's full position + real event ledger (stakes, unstakes, withdrawals, slashes) from Wicked Reputation's own records. Does NOT include WickedAPI call volume or fees paid — see the `note` field in the response for exactly what this does and doesn't cover. Args: wallet: The agent's 0x wallet address on Base.

Parameters1

wallet

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "title": "Wallet",
      "type": "string"
    }
  },
  "required": [
    "wallet"
  ],
  "title": "reputation_statementArguments"
}

reputation_query

Search/rank registered agents by tier, stake, reputation, or slash history. A safe, parameterized alternative to raw SQL — every filter is a typed query param, there's no query-injection surface. Args: tier: Exact tier name to filter to, e.g. "gold". min_stake / max_stake: Active-stake bounds in USDC. min_reputation: Minimum reputation score. founding_member: True to only show founding members. min_slash_count: Minimum number of slash events (e.g. 1 to find agents that have ever been slashed). sort: Field to sort by, optionally prefixed "-" (descending, default) or "+" (ascending). One of stake_amount, reputation_score, slash_count, registered_at. limit: Max results, 1-200. Defaults to 20.

Parameters8

tier	any	optional
min_stake	any	optional
max_stake	any	optional
min_reputation	any	optional
founding_member	any	optional
min_slash_count	any	optional
sort	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "tier": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Tier"
    },
    "min_stake": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Min Stake"
    },
    "max_stake": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Max Stake"
    },
    "min_reputation": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Min Reputation"
    },
    "founding_member": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Founding Member"
    },
    "min_slash_count": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Min Slash Count"
    },
    "sort": {
      "default": "-stake_amount",
      "title": "Sort",
      "type": "string"
    },
    "limit": {
      "default": 20,
      "title": "Limit",
      "type": "integer"
    }
  },
  "title": "reputation_queryArguments"
}

reputation_tiers

Get Wicked Reputation's live tier thresholds and benefits (min stake required, rate-limit multiplier, fee-discount %). Read at call time rather than assumed — thresholds are admin-configurable.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "title": "reputation_tiersArguments"
}

reputation_transparency

Get Wicked Reputation's live transparency numbers: treasury address, custody model, block-explorer link, unbonding cooldown, total active stake, total agents, total slash events, founding-slot counts.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "title": "reputation_transparencyArguments"
}

registry_search_tools

Search Wicked Registry for x402/MCP tools by real, live reliability data (uptime, latency, schema conformance — never fabricated). Works unauthenticated via x402 (a 402 response carries payment instructions in its body) or with a free-tier key set via REGISTRY_API_KEY. Args: category: Filter by category, e.g. "data", "crypto". protocol: Filter by protocol — "x402", "mcp", or "rest". min_score: Minimum composite score (0-100). Tools with no check history yet are excluded once this is set, rather than treated as a 0. sort: One of "score" (default), "latency", "recency". limit: Max results, 1-200. Defaults to 50.

Parameters5

category	any	optional
protocol	any	optional
min_score	any	optional
sort	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "category": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Category"
    },
    "protocol": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Protocol"
    },
    "min_score": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Min Score"
    },
    "sort": {
      "default": "score",
      "title": "Sort",
      "type": "string"
    },
    "limit": {
      "default": 50,
      "title": "Limit",
      "type": "integer"
    }
  },
  "title": "registry_search_toolsArguments"
}

registry_tool_detail

Get one tool's full score breakdown, component history, and recent real health checks from Wicked Registry. Works unauthenticated via x402, or with a free-tier key set via REGISTRY_API_KEY. Args: tool_id: The tool's Wicked Registry id, from registry_search_tools or registry_featured_tools.

Parameters1

tool_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "tool_id": {
      "title": "Tool Id",
      "type": "string"
    }
  },
  "required": [
    "tool_id"
  ],
  "title": "registry_tool_detailArguments"
}

registry_featured_tools

Get Wicked Registry's top scored active tools. Public, free, no key or payment required — a quick look before calling registry_search_tools with a specific filter.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "title": "registry_featured_toolsArguments"
}

registry_tool_badge

Get a tool's current composite reliability score. Public, free, no key or payment required — the same badge a tool owner embeds on their own docs. Args: tool_id: The tool's Wicked Registry id.

Parameters1

tool_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "tool_id": {
      "title": "Tool Id",
      "type": "string"
    }
  },
  "required": [
    "tool_id"
  ],
  "title": "registry_tool_badgeArguments"
}

registry_report_tool

File a real complaint about a tool's reliability or behavior with Wicked Registry. Public, rate-limited, no auth required. Reviewed manually by an admin — filing a report does not auto-suspend the tool. Args: tool_id: The tool's Wicked Registry id. reporter: Your wallet address, or another best-effort identifier. reason: One of "downtime", "incorrect_response", "scam_or_abuse", "schema_violation", "other". evidence: Optional free-text note or URL supporting the report.

Parameters4

tool_id	string	required
reporter	string	required
reason	string	required
evidence	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "tool_id": {
      "title": "Tool Id",
      "type": "string"
    },
    "reporter": {
      "title": "Reporter",
      "type": "string"
    },
    "reason": {
      "title": "Reason",
      "type": "string"
    },
    "evidence": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Evidence"
    }
  },
  "required": [
    "tool_id",
    "reporter",
    "reason"
  ],
  "title": "registry_report_toolArguments"
}

registry_register_tool

Register a tool you own with Wicked Registry so it starts getting real synthetic checks and a live reliability score. Requires a real signature over the exact message: "Wicked Registry — Tool Registration\nname: {name}\nendpoint: {endpoint_url}\ntimestamp: {timestamp}" signed by owner_wallet. This tool does not sign anything itself — you (or your agent's own wallet) must produce that signature first; a client-asserted wallet with no valid signature is rejected. Args: name: Tool name. endpoint_url: The tool's live, publicly reachable endpoint — checked on an interval once registered. protocol: One of "x402", "mcp", "rest". category: Free-text category, e.g. "data", "crypto". description: What the tool does. owner_wallet: The 0x wallet address that signed the registration message. signature: The 0x-prefixed ECDSA signature over the registration message. timestamp: ISO 8601 timestamp used in the signed message — must be within 10 minutes of the call. schema_url: Optional URL to a JSON Schema the tool's response validates against — enables the schema-conformance score component. Omit if the tool doesn't publish one.

Parameters9

name	string	required
endpoint_url	string	required
protocol	string	required
category	string	required
description	string	required
owner_wallet	string	required
signature	string	required
timestamp	string	required
schema_url	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "title": "Name",
      "type": "string"
    },
    "endpoint_url": {
      "title": "Endpoint Url",
      "type": "string"
    },
    "protocol": {
      "title": "Protocol",
      "type": "string"
    },
    "category": {
      "title": "Category",
      "type": "string"
    },
    "description": {
      "title": "Description",
      "type": "string"
    },
    "owner_wallet": {
      "title": "Owner Wallet",
      "type": "string"
    },
    "signature": {
      "title": "Signature",
      "type": "string"
    },
    "timestamp": {
      "title": "Timestamp",
      "type": "string"
    },
    "schema_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Schema Url"
    }
  },
  "required": [
    "name",
    "endpoint_url",
    "protocol",
    "category",
    "description",
    "owner_wallet",
    "signature",
    "timestamp"
  ],
  "title": "registry_register_toolArguments"
}

identity_get_nonce

Get a one-time nonce + message to sign for Wicked Identity — the first step before identity_register, identity_get_challenge, or identity_submit_response, each of which needs a FRESH nonce (single-use, short TTL — don't reuse one across calls). Args: wallet: Your agent's 0x wallet address on Base.

Parameters1

wallet

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "title": "Wallet",
      "type": "string"
    }
  },
  "required": [
    "wallet"
  ],
  "title": "identity_get_nonceArguments"
}

identity_register

Register your wallet with Wicked Identity — a lightweight identity record, no stake required. Requires a real signature over the exact message identity_get_nonce returned; this tool does not sign anything itself. Args: wallet: Your agent's 0x wallet address on Base. nonce: The nonce from a fresh identity_get_nonce call. signature: The 0x-prefixed ECDSA signature over that nonce's message.

Parameters3

wallet	string	required
nonce	string	required
signature	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "title": "Wallet",
      "type": "string"
    },
    "nonce": {
      "title": "Nonce",
      "type": "string"
    },
    "signature": {
      "title": "Signature",
      "type": "string"
    }
  },
  "required": [
    "wallet",
    "nonce",
    "signature"
  ],
  "title": "identity_registerArguments"
}

identity_get_challenge

Request a real, time-boxed agent-liveness challenge from Wicked Identity for an already-registered wallet. Read the returned `instructions` carefully — it's a constrained-generation task (exact word count + a letter-sum constraint) with a tight time budget (`time_budget_seconds`, default 12s); submit your answer via identity_submit_response before `expires_at`. Requires a real signature over identity_get_nonce's message — this tool does not sign anything itself. Args: wallet: Your agent's 0x wallet address on Base — must already be registered via identity_register. nonce: The nonce from a fresh identity_get_nonce call. signature: The 0x-prefixed ECDSA signature over that nonce's message.

Parameters3

wallet	string	required
nonce	string	required
signature	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "title": "Wallet",
      "type": "string"
    },
    "nonce": {
      "title": "Nonce",
      "type": "string"
    },
    "signature": {
      "title": "Signature",
      "type": "string"
    }
  },
  "required": [
    "wallet",
    "nonce",
    "signature"
  ],
  "title": "identity_get_challengeArguments"
}

identity_submit_response

Submit your answer to a Wicked Identity challenge. Scored honestly as pass / fail / inconclusive — never forced to a binary result. On pass, the response includes a short-lived signed assertion_token (a standard JWT) that anyone can verify against identity_jwks, and identity_status will report your wallet as verified until it expires. Requires a real signature over identity_get_nonce's message — this tool does not sign anything itself. Note this is a DIFFERENT nonce call than the one used for identity_get_challenge; fetch a fresh one. Args: wallet: Your agent's 0x wallet address on Base. nonce: The nonce from a fresh identity_get_nonce call. signature: The 0x-prefixed ECDSA signature over that nonce's message. challenge_id: The challenge_id from identity_get_challenge. response_text: Your answer, exactly as the challenge's instructions specify (e.g. raw lowercase words, no extra commentary).

Parameters5

wallet	string	required
nonce	string	required
signature	string	required
challenge_id	string	required
response_text	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "title": "Wallet",
      "type": "string"
    },
    "nonce": {
      "title": "Nonce",
      "type": "string"
    },
    "signature": {
      "title": "Signature",
      "type": "string"
    },
    "challenge_id": {
      "title": "Challenge Id",
      "type": "string"
    },
    "response_text": {
      "title": "Response Text",
      "type": "string"
    }
  },
  "required": [
    "wallet",
    "nonce",
    "signature",
    "challenge_id",
    "response_text"
  ],
  "title": "identity_submit_responseArguments"
}

identity_status

Check whether a wallet currently holds a valid, unexpired Wicked Identity assertion — the read-only check any third party can run on someone else's wallet, no signature needed. Works unauthenticated via x402 (a 402 response carries payment instructions in its body) or with a free-tier key set via IDENTITY_API_KEY. Args: wallet: The 0x wallet address to check.

Parameters1

wallet

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "title": "Wallet",
      "type": "string"
    }
  },
  "required": [
    "wallet"
  ],
  "title": "identity_statusArguments"
}

identity_jwks

Get Wicked Identity's public JWKS (RS256 keys) — use this to verify an assertion_token's signature locally with a standard JWT library, independent of calling identity_status. Public, free, no key needed.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "title": "identity_jwksArguments"
}

sanity_check

Verify a claim before you act on it or hand it downstream. Every verdict comes from a real model inference run at request time (HHEM entailment) — never cached or guessed. Two modes: - "grounded" (default): is the claim faithful to the `context` you supply? `context` is REQUIRED. This is a scoreable question. - "open": is the claim consistent with live web evidence found right now (real Tavily search, then the same model)? `context` is ignored. This is consistency with current web content, NOT objective truth — a claim can be well-supported by the web and still be wrong. Reading the result (in `data`): - `verdict`: "supported" (consistent with the source), "contradicted" (clearly inconsistent), "unsupported" (not supported but not clearly contradicted — treat as unverified), or "insufficient_evidence" (open mode found nothing usable; says nothing about whether the claim is true). - `confidence_score`: the raw consistency score in [0, 1] — near 1 = consistent with the source, near 0 = inconsistent. It is NOT confidence-in-the-verdict: a "contradicted" verdict has a score near 0. It is 0.0 for "insufficient_evidence". - `evidence`: the audit trail (context snippet, or web citations). Suggested policy: act on "supported"; treat "unsupported" and "insufficient_evidence" as unverified; reject or regenerate on "contradicted". Access: the public mcp.wickedapi.com server uses a shared, rate-limited key, so this returns real verdicts directly -- but the shared budget is small (about 20 requests/minute and 30 open-mode checks/day across ALL users; grounded mode is not counted against the daily limit). An http_status 429 means that shared budget is used up: retry after the Retry-After seconds, run this server locally with your own SANITY_API_KEY, or pay per call via x402 directly. A server with no key configured returns an http_status 402 carrying x402 payment instructions under `payment_required` instead. Args: claim: The single statement to verify (max 5,000 characters). context: Source text the claim must be faithful to — a string or a list of strings. Required for mode "grounded". mode: "grounded" (check against `context`) or "open" (check against live web evidence).

Parameters3

claim	string	required
context	any	optional
mode	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "claim": {
      "title": "Claim",
      "type": "string"
    },
    "context": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Context"
    },
    "mode": {
      "default": "grounded",
      "title": "Mode",
      "type": "string"
    }
  },
  "required": [
    "claim"
  ],
  "title": "sanity_checkArguments"
}

sanity_check_batch

Verify several claims in one call — use this for a multi-sentence output instead of calling sanity_check once per sentence. Split the output into individual claims, pass the source as `context`, and every claim is checked against it. One payment / one rate-limit hit covers the whole batch, and grounded batches are scored far faster than N separate calls. Returns `data` as a list with one result per claim, in the same order as `claims`; each result is shaped exactly like sanity_check's (see that tool for how to read `verdict`, `confidence_score` and `evidence`). In "open" mode a separate live web search runs per claim, so large open batches are slow. Access: the public mcp.wickedapi.com server uses a shared, rate-limited key, so this returns real verdicts directly -- but the shared budget is small (about 20 requests/minute and 30 open-mode checks/day across ALL users; grounded mode is not counted against the daily limit). An http_status 429 means that shared budget is used up: retry after the Retry-After seconds, run this server locally with your own SANITY_API_KEY, or pay per call via x402 directly. A server with no key configured returns an http_status 402 carrying x402 payment instructions under `payment_required` instead. Args: claims: 1-50 statements to verify, each up to 5,000 characters. context: Shared source text for every claim — a string or a list of strings. Required for mode "grounded". mode: "grounded" (check against `context`) or "open" (check against live web evidence).

Parameters3

claims	array	required
context	any	optional
mode	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "claims": {
      "items": {
        "type": "string"
      },
      "title": "Claims",
      "type": "array"
    },
    "context": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Context"
    },
    "mode": {
      "default": "grounded",
      "title": "Mode",
      "type": "string"
    }
  },
  "required": [
    "claims"
  ],
  "title": "sanity_check_batchArguments"
}

memory_prepare

Step 1 of every Wicked Memory call: get the exact message to sign. Wicked Memory is persistent, wallet-scoped memory for agents (store, semantic search, versioned history, hard delete). Each call needs a fresh wallet signature; this server never signs or holds a key. Sign `message_to_sign` with your wallet (EIP-191 personal_sign), then call the matching tool (memory_store, memory_search, ...) with the SAME arguments plus the returned `timestamp`, `nonce` and your `signature`. The timestamp must be within 5 minutes and the nonce is single-use, so prepare again for every call. Args: operation: One of "store", "search", "get", "update", "history", "delete", "deletions". wallet: Your agent's 0x wallet address (your memories are scoped to it). params: The same arguments you will pass to the tool, by name, e.g. {"content": "...", "tags": ["a"]} for store, {"q": "..."} for search, {"memory_id": "<uuid>"} for get/update/history/delete.

Parameters3

operation	string	required
wallet	string	required
params	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "operation": {
      "title": "Operation",
      "type": "string"
    },
    "wallet": {
      "title": "Wallet",
      "type": "string"
    },
    "params": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Params"
    }
  },
  "required": [
    "operation",
    "wallet"
  ],
  "title": "memory_prepareArguments"
}

memory_store

Store a memory in Wicked Memory (free; fair-use rate limited). Call memory_prepare with operation "store" and these same arguments first, sign its message, then pass timestamp/nonce/signature here. A real embedding is computed at write time. Returns the stored memory (`data.id`, validity window, ...). Args: wallet: Your agent's 0x wallet address (scopes the memory). content: The text to remember (max 16 KB). timestamp: From memory_prepare. nonce: From memory_prepare (single use). signature: Your wallet's signature over memory_prepare's message_to_sign. tags: Up to 20 short tags for filtering. metadata: Free-form JSON object (max 8 KB). source: Which agent/session wrote this.

Parameters8

wallet	string	required
content	string	required
timestamp	string	required
nonce	string	required
signature	string	required
tags	any	optional
metadata	any	optional
source	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "title": "Wallet",
      "type": "string"
    },
    "content": {
      "title": "Content",
      "type": "string"
    },
    "timestamp": {
      "title": "Timestamp",
      "type": "string"
    },
    "nonce": {
      "title": "Nonce",
      "type": "string"
    },
    "signature": {
      "title": "Signature",
      "type": "string"
    },
    "tags": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Tags"
    },
    "metadata": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Metadata"
    },
    "source": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Source"
    }
  },
  "required": [
    "wallet",
    "content",
    "timestamp",
    "nonce",
    "signature"
  ],
  "title": "memory_storeArguments"
}

memory_search

Semantic search over YOUR memories (scoped to `wallet`; no other wallet's memories are ever returned). Ranked by real cosine similarity computed at query time (`score`). Call memory_prepare with operation "search" and these same arguments first. Access: this is the one metered endpoint. With a free-tier key (MEMORY_API_KEY, if this server has one) it is free and rate-limited; otherwise it returns http_status 402 with x402 payment instructions under `payment_required` (0.001 USDC on Base). To pay: build and sign the x402 payment from `payment_required`, then call this tool AGAIN with the SAME arguments (same timestamp/nonce/signature, which a 402 does not consume) plus `payment_signature`. By default only currently-active versions are searched; use `as_of` to search memory as it stood at a past instant, or include_superseded=true for every version. Args: wallet: Your agent's 0x wallet address. q: What to look for, in natural language. timestamp: From memory_prepare. nonce: From memory_prepare (single use). signature: Your wallet's signature over memory_prepare's message_to_sign. limit: 1-50 results (default 10). tags: Only memories having ALL of these tags. created_after: ISO-8601 lower bound on creation time. created_before: ISO-8601 upper bound on creation time. as_of: ISO-8601 instant; search the versions valid at that moment. include_superseded: Also search old, superseded versions. payment_signature: x402 payment payload (base64) for the keyless path.

Parameters12

wallet	string	required
q	string	required
timestamp	string	required
nonce	string	required
signature	string	required
limit	any	optional
tags	any	optional
created_after	any	optional
created_before	any	optional
as_of	any	optional
include_superseded	any	optional
payment_signature	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "title": "Wallet",
      "type": "string"
    },
    "q": {
      "title": "Q",
      "type": "string"
    },
    "timestamp": {
      "title": "Timestamp",
      "type": "string"
    },
    "nonce": {
      "title": "Nonce",
      "type": "string"
    },
    "signature": {
      "title": "Signature",
      "type": "string"
    },
    "limit": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Limit"
    },
    "tags": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Tags"
    },
    "created_after": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Created After"
    },
    "created_before": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Created Before"
    },
    "as_of": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "As Of"
    },
    "include_superseded": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Include Superseded"
    },
    "payment_signature": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Payment Signature"
    }
  },
  "required": [
    "wallet",
    "q",
    "timestamp",
    "nonce",
    "signature"
  ],
  "title": "memory_searchArguments"
}

memory_get

Fetch one of your memories by id. Another wallet's id (or a deleted one) returns the same 404 as an id that never existed. Call memory_prepare with operation "get" and params {"memory_id": ...} first. Args: wallet: Your agent's 0x wallet address. memory_id: The memory's UUID. timestamp: From memory_prepare. nonce: From memory_prepare (single use). signature: Your wallet's signature over memory_prepare's message_to_sign.

Parameters5

wallet	string	required
memory_id	string	required
timestamp	string	required
nonce	string	required
signature	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "title": "Wallet",
      "type": "string"
    },
    "memory_id": {
      "title": "Memory Id",
      "type": "string"
    },
    "timestamp": {
      "title": "Timestamp",
      "type": "string"
    },
    "nonce": {
      "title": "Nonce",
      "type": "string"
    },
    "signature": {
      "title": "Signature",
      "type": "string"
    }
  },
  "required": [
    "wallet",
    "memory_id",
    "timestamp",
    "nonce",
    "signature"
  ],
  "title": "memory_getArguments"
}

memory_update

Update a memory WITHOUT overwriting it: creates a new version and closes the old one (`valid_until` / `superseded_by`), so history is kept. Omitted fields carry over. Returns `previous` and `current`. Only the current version can be updated (409 otherwise, naming the current id). Call memory_prepare with operation "update" and the same arguments first. Args: wallet: Your agent's 0x wallet address. memory_id: UUID of the CURRENT version to supersede. timestamp: From memory_prepare. nonce: From memory_prepare (single use). signature: Your wallet's signature over memory_prepare's message_to_sign. content: New text (re-embedded). Provide at least one of content/tags/metadata/source. tags: Replacement tags. metadata: Replacement metadata object. source: New source label.

Parameters9

wallet	string	required
memory_id	string	required
timestamp	string	required
nonce	string	required
signature	string	required
content	any	optional
tags	any	optional
metadata	any	optional
source	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "title": "Wallet",
      "type": "string"
    },
    "memory_id": {
      "title": "Memory Id",
      "type": "string"
    },
    "timestamp": {
      "title": "Timestamp",
      "type": "string"
    },
    "nonce": {
      "title": "Nonce",
      "type": "string"
    },
    "signature": {
      "title": "Signature",
      "type": "string"
    },
    "content": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Content"
    },
    "tags": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Tags"
    },
    "metadata": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Metadata"
    },
    "source": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Source"
    }
  },
  "required": [
    "wallet",
    "memory_id",
    "timestamp",
    "nonce",
    "signature"
  ],
  "title": "memory_updateArguments"
}

memory_history

Full version chain for a memory, oldest first, with each version's `valid_from` / `valid_until` / `superseded_by`. Works from any version's id. Call memory_prepare with operation "history" first. Args: wallet: Your agent's 0x wallet address. memory_id: UUID of any version in the chain. timestamp: From memory_prepare. nonce: From memory_prepare (single use). signature: Your wallet's signature over memory_prepare's message_to_sign.

Parameters5

wallet	string	required
memory_id	string	required
timestamp	string	required
nonce	string	required
signature	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "title": "Wallet",
      "type": "string"
    },
    "memory_id": {
      "title": "Memory Id",
      "type": "string"
    },
    "timestamp": {
      "title": "Timestamp",
      "type": "string"
    },
    "nonce": {
      "title": "Nonce",
      "type": "string"
    },
    "signature": {
      "title": "Signature",
      "type": "string"
    }
  },
  "required": [
    "wallet",
    "memory_id",
    "timestamp",
    "nonce",
    "signature"
  ],
  "title": "memory_historyArguments"
}

memory_delete

PERMANENTLY delete a memory (hard delete; right-to-be-forgotten). The content is not recoverable; only an audit row (no content) is kept. The default scope "chain" removes EVERY version of the memory; "version" removes only this one. Call memory_prepare with operation "delete" and the same arguments first. Args: wallet: Your agent's 0x wallet address. memory_id: UUID of any version in the chain. timestamp: From memory_prepare. nonce: From memory_prepare (single use). signature: Your wallet's signature over memory_prepare's message_to_sign. scope: "chain" (all versions, default) or "version" (just this row). reason: Optional note recorded in the audit log (max 200 chars).

Parameters7

wallet	string	required
memory_id	string	required
timestamp	string	required
nonce	string	required
signature	string	required
scope	string	optional
reason	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "title": "Wallet",
      "type": "string"
    },
    "memory_id": {
      "title": "Memory Id",
      "type": "string"
    },
    "timestamp": {
      "title": "Timestamp",
      "type": "string"
    },
    "nonce": {
      "title": "Nonce",
      "type": "string"
    },
    "signature": {
      "title": "Signature",
      "type": "string"
    },
    "scope": {
      "default": "chain",
      "title": "Scope",
      "type": "string"
    },
    "reason": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Reason"
    }
  },
  "required": [
    "wallet",
    "memory_id",
    "timestamp",
    "nonce",
    "signature"
  ],
  "title": "memory_deleteArguments"
}

memory_deletions

Your deletion audit log (ids, times, reasons; never content). Call memory_prepare with operation "deletions" first. Args: wallet: Your agent's 0x wallet address. timestamp: From memory_prepare. nonce: From memory_prepare (single use). signature: Your wallet's signature over memory_prepare's message_to_sign.

Parameters4

wallet	string	required
timestamp	string	required
nonce	string	required
signature	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "title": "Wallet",
      "type": "string"
    },
    "timestamp": {
      "title": "Timestamp",
      "type": "string"
    },
    "nonce": {
      "title": "Nonce",
      "type": "string"
    },
    "signature": {
      "title": "Signature",
      "type": "string"
    }
  },
  "required": [
    "wallet",
    "timestamp",
    "nonce",
    "signature"
  ],
  "title": "memory_deletionsArguments"
}

README.md9 KBView on GitHub

WickedAPI MCP Server

MCP server for the whole Wicked suite — trading data, DeFi protocol health, token safety, brokerage sync, agent identity, reputation, a tool-reliability registry, hallucination checks, persistent agent memory, and x402 paywalls, in one server.

75 tools across 10 live services. The first four are generated automatically from each service's own live openapi.json, so the list always matches what's deployed; the rest are hand-written because they use wallet signatures and non-/v1 routes:

Service	Tools	Auth
Trading Data API	22 (unprefixed: `price`, `ohlcv`, `fvg`, `momentum_score`, `sentiment`, `macro_calendar`, …)	API key or x402, 5 free
Protocol Health Oracle	6 (`protocol_health_*`)	API key or x402, scoreboard free
Token Risk Oracle	1 (`token_risk`)	100% free, no key
Broker Sync API	6 (`broker_sync_*`)	API key or x402
Wicked Reputation	5 (`reputation_*`)	free, no key
Wicked Registry	6 (`registry_*`)	search/detail: key or x402; featured/badge/report free; register needs your signature
Wicked Identity	8 (`identity_*`)	no wallet? start with `identity_sandbox_register` (no signing); free test key via `identity_get_test_key`; real-wallet calls need your signature over a nonce
Wicked Sanity	2 (`sanity_check`, `sanity_check_batch`)	key or x402
Wicked Memory	8 (`memory_prepare`, `memory_store`, `memory_search`, …)	wallet signature on every call; only search is metered
x402 Paywall	8 (`paywall_*`)	`paywall_signup` is open; the rest need the tenant key

Plus 6 resources (the platform directory, llms.txt, and each service's live endpoint catalog) and 7 prompts (rug_check, vet_dependency, morning_briefing, fact_check, verify_agent, find_reliable_tool, agent_memory_guide) that chain tools together the way the cookbook does.

These tools never sign anything or hold a key. Agents with no wallet can still try Wicked Identity end to end through a sandbox identity (identity_sandbox_register, then pass sandbox_token instead of a signature); sandbox results are for testing and are never reported as verified. Identity (real wallet), Registry registration and Memory take a signature you produce with your own wallet (identity_get_nonce / memory_prepare return the exact message to sign). Calls that need x402 payment return the real 402 challenge (decoded under payment_required for x402 v2) rather than auto-paying — WICKEDAPI_PAYER_PRIVATE_KEY auto-pay applies to the Trading, Protocol Health, Token Risk and Broker Sync tools.

Remote endpoint (no install)

The same 75 tools are served over streamable HTTP at https://mcp.wickedapi.com/mcp (stateless, rate-limited per IP; the public deployment carries no personal keys, so paid calls return the x402 challenge). Point any streamable-HTTP MCP client at it. To self-host, build the Dockerfile (or npm run build && npm run start:http); see .env.example for RATE_LIMIT_PER_MINUTE, ALLOWED_HOSTS and TRUSTED_CLIENT_IP_HEADER.

Every tool hits a real endpoint gated by x402 (HTTP-native pay-per-call, USDC on Base) with an API-key fallback — and the Token Risk Oracle tool is free no matter what:

Zero config — calls without credentials still work; paid endpoints return the real 402 payment challenge (price, network, payTo) as the tool result.
Autonomous pay-per-call — set WICKEDAPI_PAYER_PRIVATE_KEY to a funded Base-mainnet wallet's private key, and every call auto-pays ~$0.001 in USDC and returns real data. No account, no subscription.
Partner API key — set WICKEDAPI_API_KEY for free, rate-limited access across all four services (same key works everywhere).

Install

json

{
  "mcpServers": {
    "wickedapi": {
      "command": "npx",
      "args": ["-y", "@wickedlabs/wicked-mcp"],
      "env": {
        "WICKEDAPI_API_KEY": "your-key-here"
      }
    }
  }
}

Or for autonomous pay-per-call instead of a key:

json

{
  "mcpServers": {
    "wickedapi": {
      "command": "npx",
      "args": ["-y", "@wickedlabs/wicked-mcp"],
      "env": {
        "WICKEDAPI_PAYER_PRIVATE_KEY": "0xyour-base-wallet-private-key"
      }
    }
  }
}

Nothing configured? The Token Risk Oracle tool and the 5 free Trading Data API endpoints (sentiment, macro_calendar, market_overview, gas, kalshi_probability) still work with zero setup.

Resources

Read without calling a tool — useful for a client that surfaces resources in its UI:

wickedapi://platform/services — the full service directory (JSON)
wickedapi://platform/llms — the platform's llms.txt
wickedapi://trading/status, wickedapi://protocol_health/status, wickedapi://token_risk/status, wickedapi://broker_sync/status — each service's live endpoint catalog

Quick start

bash

claude mcp add --transport http wicked https://mcp.wickedapi.com/mcp   # Claude Code, no install
npx -y @wickedlabs/wicked-mcp                                                    # local stdio

Claude Desktop / Cursor / VS Code config and per-framework starters: see the cookbooks. The remote also serves a landing page at /, /llms.txt, an MCP server card at /.well-known/mcp/server-card.json, and aggregate per-tool call counts at /stats (counts only; no arguments or IPs).

Prompts

One-click workflows that chain real tool calls (Claude Desktop and other prompt-aware clients surface these directly):

rug_check (address, chain, optional symbol) — token risk check + market sentiment + optional momentum read, before buying.
vet_dependency (slug, optional token_address, chain) — protocol health + optional contract-level risk check, before building on a DeFi protocol.
morning_briefing (optional symbol) — macro calendar + earnings calendar + sentiment + momentum verdict, as one digest.
fact_check (output, optional source) — split an answer into claims and verify each with Wicked Sanity.
verify_agent (wallet) — Identity assertion + Reputation stake/tier before you transact with an agent.
find_reliable_tool (need, optional category, min_score) — Registry search by real uptime/latency/schema scores.
agent_memory_guide (wallet, task) — the two-step signed Memory flow, explained to the model.

Environment variables

Var	Required	Notes
`WICKEDAPI_API_KEY`	no	Free, rate-limited access across all four services (same key works everywhere).
`WICKEDAPI_PAYER_PRIVATE_KEY`	no	Base-mainnet wallet private key. If set, every call auto-pays the x402 challenge in USDC — no key needed.
`WICKEDAPI_BASE_URL`	no	Override the Trading Data API base (default `https://api.wickedapi.com`).
`WICKEDAPI_PROTOCOL_HEALTH_URL`	no	Override the Protocol Health Oracle base (default `https://protocol-health-oracle.wickedapi.com`).
`WICKEDAPI_TOKEN_RISK_URL`	no	Override the Token Risk Oracle base (default `https://token-risk-oracle.wickedapi.com`).
`WICKEDAPI_BROKER_SYNC_URL`	no	Override the Broker Sync API base (default `https://broker-sync-api.wickedapi.com`).
`REGISTRY_API_KEY` / `IDENTITY_API_KEY` / `SANITY_API_KEY` / `MEMORY_API_KEY`	no	Free-tier keys for the paid calls of Registry, Identity, Sanity and Memory search. Omit to get the x402 challenge instead.
`PAYWALL_API_KEY`	for `paywall_*`	Tenant Bearer key returned once by `paywall_signup`.
`REPUTATION_BASE_URL` / `REGISTRY_BASE_URL` / `IDENTITY_BASE_URL` / `SANITY_BASE_URL` / `MEMORY_BASE_URL` / `PAYWALL_BASE_URL`	no	Override the matching service base (defaults are the `*.wickedapi.com` hosts).
`WICKEDAPI_SHOWCASE_URL`	no	Override the platform directory base used by resources (default `https://wickedapi.com`).

If neither WICKEDAPI_API_KEY nor WICKEDAPI_PAYER_PRIVATE_KEY is set, paid calls still succeed at the protocol level — you'll get the real 402 challenge back as the tool result instead of data. If one service's spec fails to load (network hiccup, that service is down), its tools are simply skipped for the session — the rest still register normally.

Local development

bash

npm install
npm test            # builds, then unit + end-to-end tests (e2e needs network)
node dist/index.js  # stdio
node dist/http.js   # streamable HTTP on $PORT (default 8080)

What this is not

This server doesn't reimplement any data logic — it's a thin bridge from MCP tool calls to the live Wicked HTTP endpoints across all ten services. All the actual market data, indicators, scoring, and risk signals live in the APIs themselves.

Install

Tools (30)

wickedapi_pricewickedapi_momentumwickedapi_funding_oireputation_statusreputation_statementreputation_queryreputation_tiersreputation_transparency

Configuration

Environment variables

WICKEDAPI_API_KEYsecret

Free-tier partner key for the data services. Omit to fall back to x402.

WICKEDAPI_PAYER_PRIVATE_KEYsecret

Funded Base wallet key; auto-pays x402 for Trading, Protocol Health, Token Risk and Broker Sync calls.

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "wicked-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@wickedlabs/wicked-mcp@0.6.0"
      ],
      "env": {
        "WICKEDAPI_API_KEY": "<YOUR_WICKEDAPI_API_KEY>",
        "WICKEDAPI_PAYER_PRIVATE_KEY": "<YOUR_WICKEDAPI_PAYER_PRIVATE_KEY>"
      }
    }
  }
}

MCP Server: io.github.choaticpixels/wicked-mcp

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

wickedapi_price

wickedapi_momentum

wickedapi_funding_oi

reputation_status

reputation_statement

reputation_query

reputation_tiers

reputation_transparency

registry_search_tools

registry_tool_detail

registry_featured_tools

registry_tool_badge

registry_report_tool

registry_register_tool

identity_get_nonce

identity_register

identity_get_challenge

identity_submit_response

identity_status

identity_jwks

sanity_check

sanity_check_batch

memory_prepare

memory_store

memory_search

memory_get

memory_update

memory_history

memory_delete

memory_deletions

WickedAPI MCP Server

Remote endpoint (no install)

No signup required

Install

Resources

Quick start

Prompts

Environment variables

Local development

What this is not

Install

Configuration

Related servers