Endpoints: 76,849MCP servers: 32,730Payout addresses: 3,825Paid calls: 6,160Letters: 84Defects: 3,898counted 3 min ago
teppi

Server definition

Hash
sha256:2c71159c24c861cfddc61a8414963064409f92771daa061d66706e95302db79c
What it is
What a remote MCP server returned when asked what it offers: 8 tools

The blob, as servednamed by its sha256

{ "instructions": "Plan Data API: clean, multi-year data on U.S. retirement plans (401(k), 403(b), pension and other plans), built from\nthe Department of Labor's public Form 5500 filings, plan years 2021 onward. A plan is identified by its sponsor's EIN\nplus its 3-digit plan number (pn).\n\nTypical flow: search_plans (by company name) -> get_plan with a result's ein and pn -> get_plan_history or\nget_plan_fees for detail. find_plan_changes lists recordkeeper switches, new plans, mergers and terminations across\nplans; a recordkeeper move caused by a sale of the old recordkeeper's business is its own event type\n(recordkeeper_sold), not a switch. list_prospects lists many plans at once by industry, place and size, with sponsor address, participants,\nassets and inception date. get_coverage (free) lists what the data covers and every limitation.\n\nEvery answer is JSON with `data` and `meta`; `meta.coverage_notes` says what that record can't show. In general: small\nplans (about 9 in 10) file no Schedule C, so they have no recordkeeper, advisor or fee breakdown; Schedule C omits\nproviders paid under $5,000, fees the employer pays directly (so many advisors don't appear) and fund expense ratios;\nthe investment lineup isn't in the data; participant counts use a new definition from plan year 2023; governmental\nplans (public universities, school districts, state pensions) and most church plans don't file a Form 5500, so\nthey aren't here. Each tool\nreturns what the Plan Data API's HTTP endpoint named in its description returns: hints that mention an endpoint\n(GET /search...) mean the matching tool here.\n\nNothing here is investment, legal, tax or fiduciary advice; the terms of use are at the API's /terms.\n\nPayments: each paid tool costs a fixed price per call (search_plans $0.01, get_plan $0.03, get_plan_history $0.25, get_plan_fees $0.10, find_plan_changes $0.25, list_prospects $0.25; get_coverage free), in USDC on Base (mainnet) (eip155:8453), with x402 over MCP. Called without payment, a paid tool returns isError with the x402 PaymentRequired object; an x402 MCP client signs the payment, sends it in _meta[\"x402/payment\"] and repeats the call. Errors and empty results aren't charged: the receipt in _meta[\"x402/payment-response\"] then shows amount 0 and no transaction. No crypto wallet? Buy prepaid credits by card at https://api.form5500data.com/buy and connect with the header 'Authorization: Bearer <key>': each paid tool then takes its price from the key's balance (same prices and rules), with no x402 needed. Simplest, in an app with MCP sign-in (Claude and others): add https://api.form5500data.com/connect instead of /mcp; the app opens a page where the person pays by card and is then connected, with no key. An app connected that way pays each tool from that balance automatically (nothing to send), and get_account (free) shows the balance and a link to add credit.", "tools": [ { "description": "Change events detected by comparing each plan's consecutive filings, newest filing first. Each event\nhas before/after values, a confidence, the year compared against, a plain-English detail and the ACK ID\nof the filing that shows it.\n\nProviders are compared by family, so a rebrand (Great-West → Empower) isn't a change. A move caused by a\nsale of the old recordkeeper's business (Securian → The Standard, Prudential → Empower; the list is at\n`get_coverage` `book_sales`) is a `recordkeeper_sold` event, not a `recordkeeper_change` switch: the sponsor\ndidn't choose it. Each event also has the plan's size around the event (`net_assets_at_event`), which\n`min_assets` and `sort=assets` use. The newest plan year is still being filed, so its counts grow month to\nmonth.\n\nPrice: $0.25 per call, paid in USDC on Base (mainnet) with x402 (MCP transport), or from card credits (an app signed in at /connect, or an 'Authorization: Bearer <key>' header). Without payment the tool returns the payment requirements. Errors and empty results aren't charged.\n\nSame data as GET /changes of the Plan Data API.", "inputSchema": { "properties": { "ein": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Only this sponsor's plans (EIN, 9 digits, dashes allowed): what changed at one company.", "title": "Ein" }, "event_type": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Event type(s); repeat the parameter or separate with commas. One of: recordkeeper_change, recordkeeper_sold, advisor_added, advisor_removed, advisor_changed, auditor_change, audit_opinion_change, late_deposits_appeared, new_plan, plan_merged_in, plan_merged_out, plan_terminated, termination_resolution, filings_stopped, large_asset_jump. Meanings at `get_coverage`.", "title": "Event Type" }, "filer_size": { "anyOf": [ { "enum": [ "large", "small" ], "type": "string" }, { "type": "null" } ], "default": null, "description": "large or small, in the event's plan year.", "title": "Filer Size" }, "from_recordkeeper": { "anyOf": [ { "maxLength": 100, "minLength": 3, "type": "string" }, { "type": "null" } ], "default": null, "description": "Only recordkeeper_change events (switches) away from this recordkeeper family (any brand name). Combine with `to_recordkeeper` for one move, e.g. Empower to Fidelity. Add event_type=recordkeeper_sold to see moves caused by a sale too.", "title": "From Recordkeeper" }, "limit": { "default": 25, "description": "Events per page (1-50). Each event is about 200 tokens of JSON, so the default 25 keeps an answer compact; narrow the filters rather than asking for more.", "maximum": 50, "minimum": 1, "title": "Limit", "type": "integer" }, "min_assets": { "anyOf": [ { "minimum": 0, "type": "number" }, { "type": "null" } ], "default": null, "description": "Minimum net assets around the event (`net_assets_at_event`: the larger of the event year's start and end).", "title": "Min Assets" }, "min_confidence": { "default": "low", "description": "Lowest confidence to include: high = high only, medium = high and medium, low = all.", "enum": [ "high", "medium", "low" ], "title": "Min Confidence", "type": "string" }, "offset": { "default": 0, "description": "Events to skip (0-500).", "maximum": 500, "minimum": 0, "title": "Offset", "type": "integer" }, "plan_type": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Plan type, as in `search_plans` (e.g. 401k, dc, db).", "title": "Plan Type" }, "plan_year_from": { "anyOf": [ { "maximum": 2100, "minimum": 2000, "type": "integer" }, { "type": "null" } ], "default": null, "description": "Earliest plan year of the event.", "title": "Plan Year From" }, "plan_year_to": { "anyOf": [ { "maximum": 2100, "minimum": 2000, "type": "integer" }, { "type": "null" } ], "default": null, "description": "Latest plan year of the event.", "title": "Plan Year To" }, "pn": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "With `ein`: only this plan number.", "title": "Pn" }, "recordkeeper": { "anyOf": [ { "maxLength": 100, "minLength": 3, "type": "string" }, { "type": "null" } ], "default": null, "description": "Only recordkeeper_change events (switches) to or from this recordkeeper family (any brand name works). Add event_type=recordkeeper_sold to see moves caused by a sale too.", "title": "Recordkeeper" }, "since": { "anyOf": [ { "format": "date", "type": "string" }, { "type": "null" } ], "default": null, "description": "Only events whose filing DOL received on or after this date (YYYY-MM-DD): \"what's new since I last checked\". Excludes filings_stopped, which no filing reveals.", "title": "Since" }, "sort": { "default": "newest", "description": "newest (the default: newest filing first) or assets (largest plan first, by `net_assets_at_event`).", "enum": [ "newest", "assets" ], "title": "Sort", "type": "string" }, "state": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Two-letter state of the sponsor (latest filing).", "title": "State" }, "to_recordkeeper": { "anyOf": [ { "maxLength": 100, "minLength": 3, "type": "string" }, { "type": "null" } ], "default": null, "description": "Only recordkeeper_change events (switches) to this recordkeeper family (any brand name): plans it won. Moves caused by a sale aren't wins; add event_type=recordkeeper_sold to see them.", "title": "To Recordkeeper" } }, "title": "find_plan_changesArguments", "type": "object" }, "name": "find_plan_changes", "outputSchema": null }, { "description": "How this connection pays, its credit balance in dollars, each tool's price, and a link where the person can add credit by card. Call it when the person asks what's left or how to pay, or to connect another device to the same balance. Free. It returns no plan data.", "inputSchema": { "properties": { "new_device_code": { "default": false, "description": "true = also make a one-time code (good for 15 minutes) that connects an app on another device to this same balance without paying again. Only when the person asks for it.", "title": "New Device Code", "type": "boolean" } }, "title": "get_accountArguments", "type": "object" }, "name": "get_account", "outputSchema": null }, { "description": "What the data covers per plan year, every limitation, the coverage-note codes responses can carry,\nthe event types, the screening signals and the plan-type values. Free.\n\nAlso lists the prices and what isn't charged. Same data as GET /coverage of the Plan Data API.", "inputSchema": { "properties": {}, "title": "get_coverageArguments", "type": "object" }, "name": "get_coverage", "outputSchema": null }, { "description": "The plan as of its latest filing: identity and status, plan type and features, assets and\nparticipants, average balance and approximate return, recordkeeper, advisors and auditor, headline fees,\nscreening signals and data-quality flags.\n\nWhen the latest year is a small-plan filing (no Schedule C), the recordkeeper shown is the last one seen\non an earlier Schedule C, labeled with its year and a lower confidence. `availability` says which years\n`get_plan_history` and `get_plan_fees` will return.\n\nPrice: $0.03 per call, paid in USDC on Base (mainnet) with x402 (MCP transport), or from card credits (an app signed in at /connect, or an 'Authorization: Bearer <key>' header). Without payment the tool returns the payment requirements. Errors and empty results aren't charged.\n\nSame data as GET /plan of the Plan Data API.", "inputSchema": { "properties": { "ein": { "description": "Sponsor EIN (9 digits, dashes allowed).", "title": "Ein", "type": "string" }, "pn": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Plan number (1-999; 1 and 001 both work). Optional when the EIN sponsors only one retirement plan; otherwise the error lists the plans to choose from.", "title": "Pn" } }, "required": [ "ein" ], "title": "get_planArguments", "type": "object" }, "name": "get_plan", "outputSchema": null }, { "description": "For each large plan year: Schedule C pay by role (recordkeeping, advisory, participant advice, TPA,\ninvestment management, trustee, other) in dollars and basis points of average net assets; every provider\non the Schedule C with names as filed, codes, direct and indirect pay; Schedule H line 2i expenses as a\nsecond view; and a completeness rating with the reasons.\n\nSmall plans file no Schedule C: the response still succeeds, with `schedule_c_available: false` and the\nplan-paid expenses that small plans do report. Check `get_plan` `availability.fee_years` first to see\nwhich years have a breakdown. Fees are floors: see `meta.coverage_notes`.\n\nPrice: $0.10 per call, paid in USDC on Base (mainnet) with x402 (MCP transport), or from card credits (an app signed in at /connect, or an 'Authorization: Bearer <key>' header). Without payment the tool returns the payment requirements. Errors and empty results aren't charged.\n\nSame data as GET /fees of the Plan Data API.", "inputSchema": { "properties": { "ein": { "description": "Sponsor EIN (9 digits, dashes allowed).", "title": "Ein", "type": "string" }, "plan_year": { "anyOf": [ { "maximum": 2100, "minimum": 2000, "type": "integer" }, { "type": "null" } ], "default": null, "description": "One plan year only. Default: every year.", "title": "Plan Year" }, "pn": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Plan number (1-999). Optional when the EIN has one plan.", "title": "Pn" } }, "required": [ "ein" ], "title": "get_plan_feesArguments", "type": "object" }, "name": "get_plan_fees", "outputSchema": null }, { "description": "One entry per plan year, oldest first: the filing used, assets and participants, average balance,\napproximate return, participant growth (flagged across the 2023 counting change), the growth breakdown\n(contributions, investment return, distributions, expenses, transfers), plan-paid expenses and Schedule C\nfees in bps, the year's recordkeeper / primary advisor / auditor, and the change events detected that\nyear.\n\nPrice: $0.25 per call, paid in USDC on Base (mainnet) with x402 (MCP transport), or from card credits (an app signed in at /connect, or an 'Authorization: Bearer <key>' header). Without payment the tool returns the payment requirements. Errors and empty results aren't charged.\n\nSame data as GET /plan/history of the Plan Data API.", "inputSchema": { "properties": { "ein": { "description": "Sponsor EIN (9 digits, dashes allowed).", "title": "Ein", "type": "string" }, "pn": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Plan number (1-999). Optional when the EIN has one plan.", "title": "Pn" } }, "required": [ "ein" ], "title": "get_plan_historyArguments", "type": "object" }, "name": "get_plan_history", "outputSchema": null }, { "description": "A list of plans for prospecting or research, many per call: plan and sponsor name, mailing address,\nEIN and plan number, industry, plan type, effective (inception) date, participants and net assets at the\nend of the latest plan year, form type, recordkeeper and primary advisor last seen on Schedule C, and the\nfiling's ACK ID.\n\nFilter by industry, place (state, city, ZIP), size, plan type, effective date or recordkeeper. Large\n(long-form) filers only unless `filer_size` says otherwise. Use `search_plans` instead to find one company's\nplan by name, and `get_plan` for everything about one plan. Paging stops at offset 500: narrow the\nfilters to see more.\n\nPrice: $0.25 per call, paid in USDC on Base (mainnet) with x402 (MCP transport), or from card credits (an app signed in at /connect, or an 'Authorization: Bearer <key>' header). Without payment the tool returns the payment requirements. Errors and empty results aren't charged.\n\nSame data as GET /prospects of the Plan Data API.", "inputSchema": { "properties": { "city": { "anyOf": [ { "maxLength": 60, "minLength": 2, "type": "string" }, { "type": "null" } ], "default": null, "description": "Sponsor's city, as on the filing (case doesn't matter). Best with `state`.", "title": "City" }, "effective_after": { "anyOf": [ { "format": "date", "type": "string" }, { "type": "null" } ], "default": null, "description": "Only plans whose effective (inception) date is on or after this date (YYYY-MM-DD).", "title": "Effective After" }, "effective_before": { "anyOf": [ { "format": "date", "type": "string" }, { "type": "null" } ], "default": null, "description": "Only plans whose effective (inception) date is on or before this date (YYYY-MM-DD).", "title": "Effective Before" }, "filer_size": { "default": "large", "description": "large (the default) = long-form filers: Form 5500 with Schedule H, generally 100+ participants, with providers on Schedule C. small = 5500-SF or Schedule I. any = both.", "enum": [ "large", "small", "any" ], "title": "Filer Size", "type": "string" }, "include_ended": { "default": false, "description": "Include plans that are terminated, merged into another plan, or stopped filing. Off by default.", "title": "Include Ended", "type": "boolean" }, "industry": { "anyOf": [ { "maxLength": 200, "minLength": 2, "type": "string" }, { "type": "null" } ], "default": null, "description": "The sponsor's industry: words (\"restaurants\", \"car dealers\", \"law firms\") or a NAICS business code or its start (\"62\" = health care, \"5411\" = legal services). Separate several with commas. `meta.query.industry` lists the codes each one matched.", "title": "Industry" }, "limit": { "default": 50, "description": "Plans per page (1-100). The price is per call, whatever the limit.", "maximum": 100, "minimum": 1, "title": "Limit", "type": "integer" }, "max_assets": { "anyOf": [ { "minimum": 0, "type": "number" }, { "type": "null" } ], "default": null, "description": "Maximum end-of-year net assets in dollars.", "title": "Max Assets" }, "max_participants": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "default": null, "description": "Maximum end-of-year participants.", "title": "Max Participants" }, "min_assets": { "anyOf": [ { "minimum": 0, "type": "number" }, { "type": "null" } ], "default": null, "description": "Minimum end-of-year net assets in dollars, in the plan's latest plan year.", "title": "Min Assets" }, "min_participants": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "default": null, "description": "Minimum end-of-year participants, in the plan's latest plan year.", "title": "Min Participants" }, "offset": { "default": 0, "description": "Plans to skip (0-500).", "maximum": 500, "minimum": 0, "title": "Offset", "type": "integer" }, "plan_type": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Plan type, as in `search_plans` (e.g. 401k, dc, db).", "title": "Plan Type" }, "recordkeeper": { "anyOf": [ { "maxLength": 100, "minLength": 3, "type": "string" }, { "type": "null" } ], "default": null, "description": "Only plans whose latest Schedule C names this recordkeeper (any brand, matched to its family as in `search_plans`).", "title": "Recordkeeper" }, "sort": { "default": "assets", "description": "assets (largest first, the default), participants (most first), name (A-Z by sponsor) or newest_plan (latest effective date first).", "enum": [ "assets", "participants", "name", "newest_plan" ], "title": "Sort", "type": "string" }, "state": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Two-letter state of the sponsor's address, e.g. OH.", "title": "State" }, "zip": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Sponsor's ZIP code or its start (3-5 digits), e.g. 432 for the Columbus, OH area.", "title": "Zip" } }, "title": "list_prospectsArguments", "type": "object" }, "name": "list_prospects", "outputSchema": null }, { "description": "Find plans. Give at least one of `name`, `ein`, `state` or `recordkeeper`; the other filters narrow\nthe list. Each result is a short summary: call `get_plan` with its `ein` and `pn` for the profile.\n\nWith `name`, results are ordered by match score, then size; without it, largest plans first. Plans\nthat ended are hidden unless `include_ended=true`. Paging stops at offset 500: narrow the filters to\nsee more.\n\nPrice: $0.01 per call, paid in USDC on Base (mainnet) with x402 (MCP transport), or from card credits (an app signed in at /connect, or an 'Authorization: Bearer <key>' header). Without payment the tool returns the payment requirements. Errors and empty results aren't charged.\n\nSame data as GET /search of the Plan Data API.", "inputSchema": { "properties": { "ein": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Sponsor EIN (9 digits, dashes allowed). Lists every retirement plan under it.", "title": "Ein" }, "filer_size": { "anyOf": [ { "enum": [ "large", "small" ], "type": "string" }, { "type": "null" } ], "default": null, "description": "large = files Schedule H (generally 100+ participants; has providers and fees); small = 5500-SF or Schedule I.", "title": "Filer Size" }, "include_ended": { "default": false, "description": "Include plans that are terminated, merged into another plan, or stopped filing. Off by default.", "title": "Include Ended", "type": "boolean" }, "limit": { "default": 10, "description": "Results per page (1-50).", "maximum": 50, "minimum": 1, "title": "Limit", "type": "integer" }, "max_assets": { "anyOf": [ { "minimum": 0, "type": "number" }, { "type": "null" } ], "default": null, "description": "Maximum end-of-year net assets in dollars.", "title": "Max Assets" }, "max_participants": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "default": null, "description": "Maximum end-of-year total participants.", "title": "Max Participants" }, "min_assets": { "anyOf": [ { "minimum": 0, "type": "number" }, { "type": "null" } ], "default": null, "description": "Minimum end-of-year net assets in dollars, latest plan year.", "title": "Min Assets" }, "min_participants": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "default": null, "description": "Minimum end-of-year total participants.", "title": "Min Participants" }, "name": { "anyOf": [ { "maxLength": 100, "minLength": 2, "type": "string" }, { "type": "null" } ], "default": null, "description": "Company or plan name, as you know it. Fuzzy: typos, missing suffixes (Inc, LLC), DBA names and former names all match, and the last word can be a prefix (\"starb\"). Results come best match first with a `match` score.", "title": "Name" }, "offset": { "default": 0, "description": "Results to skip (0-500).", "maximum": 500, "minimum": 0, "title": "Offset", "type": "integer" }, "plan_type": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Plan type: 401k, 403b, cash_balance, db_and_dc, defined_benefit, esop, ira_based, money_purchase, other_dc, profit_sharing, stock_bonus, target_benefit, type_not_coded, db, dc. `dc` = any defined contribution plan, `db` = any defined benefit plan.", "title": "Plan Type" }, "recordkeeper": { "anyOf": [ { "maxLength": 100, "minLength": 3, "type": "string" }, { "type": "null" } ], "default": null, "description": "Recordkeeper, any brand old or new (\"Empower\", \"Great-West\", \"Fidelity\"). Matched to the firm's family, so Great-West and Prudential filings count as Empower. Only plans that filed a Schedule C can match. `meta.query.recordkeeper` shows what it resolved to.", "title": "Recordkeeper" }, "state": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Two-letter state of the sponsor's address, e.g. TX.", "title": "State" } }, "title": "search_plansArguments", "type": "object" }, "name": "search_plans", "outputSchema": null } ] }
Verify it yourselfcurl -s https://api.teppi.xyz/v1/evidence/sha256:2c71159c24c861cfddc61a8414963064409f92771daa061d66706e95302db79c | sha256sum