tradallo-reputation
OfficialThe Tradallo reputation server lets you query and cryptographically verify (ed25519) trading reputation data for humans and AI agents. All responses are JCS-canonicalized and verified against Tradallo's public key registry before being returned.
Get Track Records (
get_track_record): Fetch verified performance stats (Sharpe ratio, win rate, max drawdown, PnL, trade count) for a human or agent handle, across all-time and rolling 30/90/365-day windows.Search Records (
search_records): Discover trading records by filtering on Sharpe ratio, trade count, drawdown, venue, and principal type — sorted by your chosen metric.Verify a Universal Trade Receipt (
verify_utr): Look up a trade receipt by SHA-256 hash to confirm on-chain anchoring via Solana memo, returning chain, signature, slot, explorer URL, and notarizer pubkey for independent verification.Get Agent Version History (
get_versions): Retrieve an agent's full version history, including semver tags, version/policy hashes, and deployment timestamps.Fetch Raw Trade Receipts (
get_utrs): Get paginated raw Universal Trade Receipts (UTRs) for an agent, each with a recomputed SHA-256 hash for spot-checking, filterable by timestamp and page size.
Allows verifying if a Universal Trade Receipt (UTR) hash has been anchored on the Solana blockchain via a Solana memo, providing on-chain verification details such as chain, signature, slot, and Solana Explorer URL.
This server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions:
@tradallo/reputation
MCP server + TypeScript client + CLI for the Tradallo Verified Record Protocol. Three ways to query cryptographically-verified human and agent trading records:
# CLI — pretty terminal cards, no install required
npx @tradallo/reputation card alpha-momentum-v3 --agent
# MCP — drop into Claude Desktop / Cursor / any MCP client (config below)
# Programmatic — typed TS/JS client
import { TradalloClient } from "@tradallo/reputation";Every response is JCS-canonicalized + ed25519-verified against Tradallo's published pubkey at tradallo.com/.well-known/tradallo-pubkeys.json before being surfaced. The signature lives in the envelope; this client fetches the pubkey registry, resolves the key_id, verifies the signature, and only then returns the data. Replay protection via served_at + max_age_seconds.
Install
Claude Desktop
Add to your claude_desktop_config.json (Settings → Developer → Edit Config):
{
"mcpServers": {
"tradallo-reputation": {
"command": "npx",
"args": ["-y", "@tradallo/reputation"]
}
}
}Restart Claude Desktop. The Tradallo tools should appear in the tool palette.
Cursor
Add to ~/.cursor/mcp.json (or via Cursor Settings → MCP):
{
"mcpServers": {
"tradallo-reputation": {
"command": "npx",
"args": ["-y", "@tradallo/reputation"]
}
}
}Generic MCP client
npx @tradallo/reputationSpeaks MCP over stdio.
Local dev / staging
Point at your own deploy by setting TRADALLO_BASE_URL:
{
"mcpServers": {
"tradallo-reputation": {
"command": "npx",
"args": ["-y", "@tradallo/reputation"],
"env": { "TRADALLO_BASE_URL": "http://localhost:3000" }
}
}
}Related MCP server: aip-identity
CLI
The same binary doubles as a terminal CLI when invoked with a subcommand:
# Pretty card with verification status, stats, version metadata
npx @tradallo/reputation card alpha-momentum-v3 --agent
# Raw verified JSON (for piping into jq, etc.)
npx @tradallo/reputation track-record alpha-momentum-v3 --agent
# Discovery
npx @tradallo/reputation search --min-sharpe 1.5 --min-trades 200 --sort-by sharpe
# Agent version history
npx @tradallo/reputation versions alpha-momentum-v3
# Paginated UTRs
npx @tradallo/reputation utrs alpha-momentum-v3 --limit 50
# Look up a specific UTR by hash
npx @tradallo/reputation verify <sha256-hex> alpha-momentum-v3
# Help
npx @tradallo/reputation helpNO_COLOR=1 disables ANSI. TRADALLO_BASE_URL overrides the API base.
Programmatic client
Embed the verifying client in your own TS/JS code:
import { TradalloClient } from "@tradallo/reputation";
const client = new TradalloClient(); // defaults to https://tradallo.com
// Throws if signature invalid, replay window expired, or pubkey unknown.
// Returns the verified `data` payload (not the envelope wrapper).
const record = await client.getSigned<{ stats: { all_time: { sharpe_ratio: number | null } } }>(
"/api/v1/agents/alpha-momentum-v3/track-record",
);
if ((record.stats.all_time.sharpe_ratio ?? 0) >= 1.5) {
// ... delegate capital, copy trades, etc.
}The verification flow happens INSIDE getSigned. If anything fails — bad signature, expired envelope, unknown key, schema mismatch — the call throws. You never see unverified data.
Tools
get_track_record(handle, principal_type?)
Fetch a verified track record for a Tradallo profile or agent.
Inputs:
handle(string, required) — the Tradallo handle (e.g.aaronjordan,alpha-momentum-v3)principal_type("human"|"agent", optional, default"agent") — which namespace to look in
Returns: the full signed payload (verification level, all-time + rolling 30/90/365d stats including Sharpe, max drawdown, win rate, PnL, expectancy).
Example use:
"Show me Aaron Jordan's verified trading record on Tradallo."
search_records(filters)
Discover verified records matching performance criteria.
Inputs (all optional): min_sharpe, min_trades, max_drawdown, venue, principal_type, sort_by, limit.
Returns: sorted list of human/agent summaries with their stats. Signature-verified.
verify_utr(utr_hash)
Look up a Universal Trade Receipt by hash. Returns whether Tradallo has anchored that hash on-chain via a Solana memo, and if so the chain, signature, slot, posted_at, Solana Explorer URL, and notarizer pubkey so the caller can independently verify on-chain.
Returns: { found, anchored_on_chain, chain?, signature?, slot?, posted_at?, explorer_url?, notarizer_pubkey? }.
get_versions(agent_handle)
Fetch an agent's full version history (semver tags, version_hash, policy_hash, when each version was deployed and superseded). Signature-verified.
get_utrs(agent_handle, since?, limit?)
Fetch raw Universal Trade Receipts for an agent, paginated cursor-style on closed_at. Each receipt includes its SHA-256 hash recomputed by Tradallo so consumers can spot-check individual records.
How verification works
Every signed Tradallo API response wraps the data in a JCS-canonicalized (RFC 8785) envelope with an ed25519 signature:
{
"data": { ... },
"schema_version": "1",
"served_at": "2026-04-30T22:29:52.776Z",
"max_age_seconds": 60,
"signature": {
"alg": "ed25519",
"key_id": "tradallo-prod-2026-04",
"sig": "<base64>"
}
}This MCP server:
Fetches
/.well-known/tradallo-pubkeys.json(cached 5 min)Resolves
signature.key_id→ ed25519 public keyJCS-canonicalizes
{data, schema_version, served_at, max_age_seconds}Verifies the signature against the pubkey
Rejects responses where
now > served_at + max_age_seconds(replay protection)
If any check fails, the tool call returns an error rather than the data. The agent is told why.
Why this matters
Identity (who is the agent) and payments (how does it pay) are solved in 2026 by x402, MPP, Coinbase Agentic Wallets, and ERC-8004. Reputation is not. When an agent decides whether to delegate capital, copy trades, or subscribe to signals from another party, it needs a way to ask: "is their record real?"
This MCP server is the lowest-friction way to ask that question.
x402 — what's coming
Today the public API is anonymous and IP-rate-limited (60 req/min). We're rolling out tiered access via x402, the HTTP 402 payment-required standard, so agents can pay USDC micro-transactions on Base to bypass rate limits and unlock higher-throughput tiers without any signup or API-key dance.
Forward-compatible expectations:
Anonymous: 60 req/min/IP (today, free)
Active subscriber: 600 req/min via API key (in dev — Phase 4.4)
x402 micro-payment: per-call USDC payment for one-shot heavy queries; no account required (planned Phase 4.5)
Operator / Fleet tiers: webhook subscriptions, custom subdomains, priority indexing
The rate-limit response will gain an x402 payment-options block once the facilitator pipeline is wired. This MCP server will start auto-paying when it sees a 402 with x402 metadata. Until then, all queries are free and verifiable.
Reference agent
A working example agent that queries Tradallo before delegating capital: github.com/tradallo/agent.
Spec & docs
Protocol overview: docs/PROTOCOL.md
Spec: docs/SPEC_V1.1.md
Public API: https://tradallo.com/api/v1/
Pubkey registry: https://tradallo.com/.well-known/tradallo-pubkeys.json
Changelog
See CHANGELOG.md.
License
MIT
Available Tools
5 toolsget_track_recordAInspect
Fetch a verified trading track record for a Tradallo profile (human) or agent. Returns cryptographically-verified statistics (Sharpe, win rate, max drawdown, PnL, trade count) computed from on-chain or in-house-sim trade history. The signature is ed25519-verified against Tradallo's published pubkey before this tool returns.
Inputs: handle (required), principal_type.
get_utrsAInspect
Fetch raw Universal Trade Receipts for an agent. Each UTR is a v2 canonical receipt with its SHA-256 hash recomputed by Tradallo so consumers can spot-check individual receipts. Paginated cursor-style on closed_at.
Inputs: agent_handle (required), since, limit.
get_versionsAInspect
Fetch the full version history of an agent (semver tags, version_hash, policy_hash, when each version was deployed and superseded). Useful for understanding which version of an agent's policy produced a given track record. The response is signature-verified.
Inputs: agent_handle (required).
search_recordsAInspect
Search verified trading records by performance filters (Sharpe, max drawdown, trade count, venue, principal type). Returns a list of summary records sorted by the chosen metric. Useful for an agent shopping for strategies that meet specific risk/return criteria. The response is signature-verified against Tradallo's published pubkey before being returned.
Inputs: min_sharpe, min_trades, max_drawdown, venue, +3 more.
verify_utrAInspect
Look up a Universal Trade Receipt by hash. Returns whether Tradallo has anchored that hash on-chain via a Solana memo transaction, and if so, returns the chain, signature, slot, posted_at, explorer URL, and notarizer pubkey so the caller can independently verify the anchor on Solana Explorer. The signed-envelope response is ed25519-verified before this tool returns.
Inputs: utr_hash (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool serves a clear, distinct purpose: fetching a track record, fetching raw receipts, retrieving version history, searching records by filters, and verifying a receipt's on-chain anchor. No two tools overlap in functionality, and descriptions clearly differentiate them.
All tool names follow a consistent verb_noun pattern (get_track_record, get_utrs, get_versions, search_records, verify_utr), using lowercase with underscores. The naming is predictable and easy to parse.
Five tools is ideal for this domain: they cover the core operations (fetching individual records, listing receipts, version history, search, and verification) without unnecessary bloat. The scope is well-defined and each tool earns its place.
The tool set provides a complete surface for querying and verifying trading reputation data: individual track records, raw receipts, version history, search by filters, and cryptographic verification. No obvious gaps exist for a read-only verification service.
Maintenance
Related MCP Connectors
Signed, Merkle-proofed, on-chain-anchored trust records for MCP servers. Verify, do not trust.
Public read-only MCP server for HODLXXI agent identity, trust, receipts, and verification.
Free trust records for AI agents and MCP servers: trust checks, sybil signals, signed attestations.
Agent-native MCP server over the public saagarpatel.dev corpus. Read-only, stateless.
Related MCP Servers
- AlicenseAqualityFmaintenanceMCP server for AgentFolio — the identity and reputation layer for AI agents. Query agent profiles, trust scores, verification status, and marketplace listings through 8 MCP tools.9135 npm1MIT
- AlicenseAqualityDmaintenanceMCP server for AI agent identity — verify agents with Ed25519 signatures, check trust scores, sign and verify content, exchange encrypted messages. Built on the Agent Identity Protocol (AIP).81MIT
- FlicenseAqualityCmaintenanceReputation and trust scoring service for AI agents, exposed as an MCP server. Evaluate counterparties, report interactions, issue portable trust certificates, and detect Sybil attacks.2370 PyPI-
- AlicenseAqualityDmaintenanceAn MCP server that bridges ERC-8004 agent identity, reputation, and validation registries into tool calls, enabling discovery, inspection, and verification of on-chain AI agents from any MCP client.8MIT