Plan Data API is an MCP server published by com.form5500data, hosted at api.form5500data.com. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 8 tools, including search_plans, get_plan, get_plan_history, get_plan_fees, find_plan_changes.
Form 5500 data for prospecting and research: U.S. retirement plans, recordkeepers, fees, switches.
14 connections through 4 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Find plans. Give at least one of `name`, `ein`, `state` or `recordkeeper`; the other filters narrow the list. Each result is a short summary: call `get_plan` with its `ein` and `pn` for the profile. With `name`, results are ordered by match score, then size; without it, largest plans first. Plans that ended are hidden unless `include_ended=true`. Paging stops at offset 500: narrow the filters to see more. Price: $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. Same data as GET /search of the Plan Data API.
| Parameter | Type | Description |
|---|---|---|
| ein | any | Sponsor EIN (9 digits, dashes allowed). Lists every retirement plan under it. |
| name | any | 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 ("acm" for Acme). Results come best match first with a `match` score. |
| limit | integer | Results per page (1-50). |
| state | any | Two-letter state of the sponsor's address, e.g. TX. |
| offset | integer | Results to skip (0-500). |
| plan_type | any | 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. |
| filer_size | any | large = files Schedule H (generally 100+ participants; has providers and fees); small = 5500-SF or Schedule I. |
| max_assets | any | Maximum end-of-year net assets in dollars. |
| min_assets | any | Minimum end-of-year net assets in dollars, latest plan year. |
| recordkeeper | any | 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. |
| include_ended | boolean | Include plans that are terminated, merged into another plan, or stopped filing. Off by default. |
| max_participants | any | Maximum end-of-year total participants. |
| min_participants | any | Minimum end-of-year total participants. |
{
"name": "search_plans",
"title": "Find plans by company name, EIN, state, size, recordkeeper or plan type",
"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": {
"type": "object",
"title": "search_plansArguments",
"properties": {
"ein": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Ein",
"default": null,
"description": "Sponsor EIN (9 digits, dashes allowed). Lists every retirement plan under it."
},
"name": {
"anyOf": [
{
"type": "string",
"maxLength": 100,
"minLength": 2
},
{
"type": "null"
}
],
"title": "Name",
"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 (\"acm\" for Acme). Results come best match first with a `match` score."
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 10,
"maximum": 50,
"minimum": 1,
"description": "Results per page (1-50)."
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "State",
"default": null,
"description": "Two-letter state of the sponsor's address, e.g. TX."
},
"offset": {
"type": "integer",
"title": "Offset",
"default": 0,
"maximum": 500,
"minimum": 0,
"description": "Results to skip (0-500)."
},
"plan_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Plan Type",
"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."
},
"filer_size": {
"anyOf": [
{
"enum": [
"large",
"small"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Filer Size",
"default": null,
"description": "large = files Schedule H (generally 100+ participants; has providers and fees); small = 5500-SF or Schedule I."
},
"max_assets": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Max Assets",
"default": null,
"description": "Maximum end-of-year net assets in dollars."
},
"min_assets": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Min Assets",
"default": null,
"description": "Minimum end-of-year net assets in dollars, latest plan year."
},
"recordkeeper": {
"anyOf": [
{
"type": "string",
"maxLength": 100,
"minLength": 3
},
{
"type": "null"
}
],
"title": "Recordkeeper",
"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."
},
"include_ended": {
"type": "boolean",
"title": "Include Ended",
"default": false,
"description": "Include plans that are terminated, merged into another plan, or stopped filing. Off by default."
},
"max_participants": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Max Participants",
"default": null,
"description": "Maximum end-of-year total participants."
},
"min_participants": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Min Participants",
"default": null,
"description": "Minimum end-of-year total participants."
}
}
},
"annotations": {
"title": "Find plans by company name, EIN, state, size, recordkeeper or plan type",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}The plan as of its latest filing: identity and status, plan type and features, assets and participants, average balance and approximate return, recordkeeper, advisors and auditor, headline fees, screening signals and data-quality flags. When the latest year is a small-plan filing (no Schedule C), the recordkeeper shown is the last one seen on an earlier Schedule C, labeled with its year and a lower confidence. `availability` says which years `get_plan_history` and `get_plan_fees` will return. Price: $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. Same data as GET /plan of the Plan Data API.
| Parameter | Type | Description |
|---|---|---|
| pn | any | 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. |
| ein * | string | Sponsor EIN (9 digits, dashes allowed). |
{
"name": "get_plan",
"title": "Latest clean profile of one plan",
"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": {
"type": "object",
"title": "get_planArguments",
"required": [
"ein"
],
"properties": {
"pn": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Pn",
"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."
},
"ein": {
"type": "string",
"title": "Ein",
"description": "Sponsor EIN (9 digits, dashes allowed)."
}
}
},
"annotations": {
"title": "Latest clean profile of one plan",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}One entry per plan year, oldest first: the filing used, assets and participants, average balance, approximate return, participant growth (flagged across the 2023 counting change), the growth breakdown (contributions, investment return, distributions, expenses, transfers), plan-paid expenses and Schedule C fees in bps, the year's recordkeeper / primary advisor / auditor, and the change events detected that year. Price: $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. Same data as GET /plan/history of the Plan Data API.
| Parameter | Type | Description |
|---|---|---|
| pn | any | Plan number (1-999). Optional when the EIN has one plan. |
| ein * | string | Sponsor EIN (9 digits, dashes allowed). |
{
"name": "get_plan_history",
"title": "Every plan year of one plan: assets, participants, growth breakdown, providers, events",
"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": {
"type": "object",
"title": "get_plan_historyArguments",
"required": [
"ein"
],
"properties": {
"pn": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Pn",
"default": null,
"description": "Plan number (1-999). Optional when the EIN has one plan."
},
"ein": {
"type": "string",
"title": "Ein",
"description": "Sponsor EIN (9 digits, dashes allowed)."
}
}
},
"annotations": {
"title": "Every plan year of one plan: assets, participants, growth breakdown, providers, events",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}For each large plan year: Schedule C pay by role (recordkeeping, advisory, participant advice, TPA, investment management, trustee, other) in dollars and basis points of average net assets; every provider on the Schedule C with names as filed, codes, direct and indirect pay; Schedule H line 2i expenses as a second view; and a completeness rating with the reasons. Small plans file no Schedule C: the response still succeeds, with `schedule_c_available: false` and the plan-paid expenses that small plans do report. Years with no Schedule C return no breakdown and aren't charged. Fees are floors: see `meta.coverage_notes`. Price: $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. Same data as GET /fees of the Plan Data API.
| Parameter | Type | Description |
|---|---|---|
| pn | any | Plan number (1-999). Optional when the EIN has one plan. |
| ein * | string | Sponsor EIN (9 digits, dashes allowed). |
| plan_year | any | One plan year only. Default: every year. |
{
"name": "get_plan_fees",
"title": "Schedule C fee breakdown in dollars and bps, with completeness notes",
"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. Years with no Schedule C return no breakdown and aren't\ncharged. 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": {
"type": "object",
"title": "get_plan_feesArguments",
"required": [
"ein"
],
"properties": {
"pn": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Pn",
"default": null,
"description": "Plan number (1-999). Optional when the EIN has one plan."
},
"ein": {
"type": "string",
"title": "Ein",
"description": "Sponsor EIN (9 digits, dashes allowed)."
},
"plan_year": {
"anyOf": [
{
"type": "integer",
"maximum": 2100,
"minimum": 2000
},
{
"type": "null"
}
],
"title": "Plan Year",
"default": null,
"description": "One plan year only. Default: every year."
}
}
},
"annotations": {
"title": "Schedule C fee breakdown in dollars and bps, with completeness notes",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Change events detected by comparing each plan's consecutive filings, newest filing first. Each event has before/after values, a confidence, the year compared against, a plain-English detail and the ACK ID of the filing that shows it. Providers are compared by family, so a rebrand (Great-West → Empower) isn't a change. A move caused by a sale of the old recordkeeper's business (Securian → The Standard, Prudential → Empower; the list is at `get_coverage` `book_sales`) is a `recordkeeper_sold` event, not a `recordkeeper_change` switch: the sponsor didn't choose it. Each event also has the plan's size around the event (`net_assets_at_event`), which `min_assets` and `sort=assets` use. The newest plan year is still being filed, so its counts grow month to month. Price: $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. Same data as GET /changes of the Plan Data API.
| Parameter | Type | Description |
|---|---|---|
| pn | any | With `ein`: only this plan number. |
| ein | any | Only this sponsor's plans (EIN, 9 digits, dashes allowed): what changed at one company. |
| sort | string | newest (the default: newest filing first) or assets (largest plan first, by `net_assets_at_event`). |
| limit | integer | 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. |
| since | any | 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. |
A list of plans for prospecting or research, many per call: plan and sponsor name, mailing address, EIN and plan number, industry, plan type, effective (inception) date, participants and net assets at the end of the latest plan year, form type, recordkeeper and primary advisor last seen on Schedule C, and the filing's ACK ID. Filter by industry, place (state, city, ZIP), size, plan type, effective date or recordkeeper. Large (long-form) filers only unless `filer_size` says otherwise. Use `search_plans` instead to find one company's plan by name, and `get_plan` for everything about one plan. Paging stops at offset 500: narrow the filters to see more. Price: $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. Same data as GET /prospects of the Plan Data API.
| Parameter | Type | Description |
|---|---|---|
| zip | any | Sponsor's ZIP code or its start (3-5 digits), e.g. 432 for the Columbus, OH area. |
| city | any | Sponsor's city, as on the filing (case doesn't matter). Best with `state`. |
| sort | string | assets (largest first, the default), participants (most first), name (A-Z by sponsor) or newest_plan (latest effective date first). |
| limit | integer | Plans per page (1-100). The price is per call, whatever the limit. |
| state | any | Two-letter state of the sponsor's address, e.g. OH. |
| offset | integer |
What the data covers per plan year, every limitation, the coverage-note codes responses can carry, the event types, the screening signals and the plan-type values. Free. Also lists the prices and what isn't charged. Same data as GET /coverage of the Plan Data API.
No parameters.
{
"name": "get_coverage",
"title": "Data coverage and limitations",
"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": {
"type": "object",
"title": "get_coverageArguments",
"properties": {}
},
"annotations": {
"title": "Data coverage and limitations",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| new_device_code | boolean | 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. |
{
"name": "get_account",
"title": "Your credit balance, and how to add more",
"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": {
"type": "object",
"title": "get_accountArguments",
"properties": {
"new_device_code": {
"type": "boolean",
"title": "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."
}
}
},
"annotations": {
"title": "Your credit balance, and how to add more",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Plan Data API: clean, multi-year data on U.S. retirement plans (401(k), 403(b), pension and other plans), built from the Department of Labor's public Form 5500 filings, plan years 2021 onward. A plan is identified by its sponsor's EIN plus its 3-digit plan number (pn). Typical flow: search_plans (by company name) -> get_plan with a result's ein and pn -> get_plan_history or get_plan_fees for detail. find_plan_changes lists recordkeeper switches, new plans, mergers and terminations across plans; a recordkeeper move caused by a sale of the old recordkeeper's business is its own event type (recordkeeper_sold), not a switch. list_prospects lists many plans at once by industry, place and size, with sponsor address, participants, assets and inception date. get_coverage (free) lists what the data covers and every limitation. Every answer is JSON with `data` and `meta`; `meta.coverage_notes` says what that record can't show. In general: small plans (about 9 in 10) file no Schedule C, so they have no recordkeeper, advisor or fee breakdown; Schedule C omits providers paid under $5,000, fees the employer pays directly (so many advisors don't appear) and fund expense ratios; the investment lineup isn't in the data; participant counts use a new definition from plan year 2023; governmental plans (public universities, school districts, state pensions) and most church plans don't file a Form 5500, so they aren't here. Each tool returns what the Plan Data API's HTTP endpoint named in its description returns: hints that mention an endpoint (GET /search...) mean the matching tool here. Nothing here is investment, legal, tax or fiduciary advice; the terms of use are at the API's /terms. Payments: 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.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
| state | any | Two-letter state of the sponsor (latest filing). |
| offset | integer | Events to skip (0-500). |
| plan_type | any | Plan type, as in `search_plans` (e.g. 401k, dc, db). |
| event_type | any | 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_resoluti… |
| filer_size | any | large or small, in the event's plan year. |
| min_assets | any | Minimum net assets around the event (`net_assets_at_event`: the larger of the event year's start and end). |
| plan_year_to | any | Latest plan year of the event. |
| recordkeeper | any | 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. |
| min_confidence | string | Lowest confidence to include: high = high only, medium = high and medium, low = all. |
| plan_year_from | any | Earliest plan year of the event. |
| to_recordkeeper | any | 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. |
| from_recordkeeper | any | 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. |
{
"name": "find_plan_changes",
"title": "Change events across plans: recordkeeper switches, new plans, mergers, terminations...",
"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": {
"type": "object",
"title": "find_plan_changesArguments",
"properties": {
"pn": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Pn",
"default": null,
"description": "With `ein`: only this plan number."
},
"ein": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Ein",
"default": null,
"description": "Only this sponsor's plans (EIN, 9 digits, dashes allowed): what changed at one company."
},
"sort": {
"enum": [
"newest",
"assets"
],
"type": "string",
"title": "Sort",
"default": "newest",
"description": "newest (the default: newest filing first) or assets (largest plan first, by `net_assets_at_event`)."
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 25,
"maximum": 50,
"minimum": 1,
"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."
},
"since": {
"anyOf": [
{
"type": "string",
"format": "date"
},
{
"type": "null"
}
],
"title": "Since",
"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."
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "State",
"default": null,
"description": "Two-letter state of the sponsor (latest filing)."
},
"offset": {
"type": "integer",
"title": "Offset",
"default": 0,
"maximum": 500,
"minimum": 0,
"description": "Events to skip (0-500)."
},
"plan_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Plan Type",
"default": null,
"description": "Plan type, as in `search_plans` (e.g. 401k, dc, db)."
},
"event_type": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Event Type",
"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`."
},
"filer_size": {
"anyOf": [
{
"enum": [
"large",
"small"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Filer Size",
"default": null,
"description": "large or small, in the event's plan year."
},
"min_assets": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Min Assets",
"default": null,
"description": "Minimum net assets around the event (`net_assets_at_event`: the larger of the event year's start and end)."
},
"plan_year_to": {
"anyOf": [
{
"type": "integer",
"maximum": 2100,
"minimum": 2000
},
{
"type": "null"
}
],
"title": "Plan Year To",
"default": null,
"description": "Latest plan year of the event."
},
"recordkeeper": {
"anyOf": [
{
"type": "string",
"maxLength": 100,
"minLength": 3
},
{
"type": "null"
}
],
"title": "Recordkeeper",
"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."
},
"min_confidence": {
"enum": [
"high",
"medium",
"low"
],
"type": "string",
"title": "Min Confidence",
"default": "low",
"description": "Lowest confidence to include: high = high only, medium = high and medium, low = all."
},
"plan_year_from": {
"anyOf": [
{
"type": "integer",
"maximum": 2100,
"minimum": 2000
},
{
"type": "null"
}
],
"title": "Plan Year From",
"default": null,
"description": "Earliest plan year of the event."
},
"to_recordkeeper": {
"anyOf": [
{
"type": "string",
"maxLength": 100,
"minLength": 3
},
{
"type": "null"
}
],
"title": "To Recordkeeper",
"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."
},
"from_recordkeeper": {
"anyOf": [
{
"type": "string",
"maxLength": 100,
"minLength": 3
},
{
"type": "null"
}
],
"title": "From Recordkeeper",
"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."
}
}
},
"annotations": {
"title": "Change events across plans: recordkeeper switches, new plans, mergers, terminations...",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}| Plans to skip (0-500). |
| industry | any | 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. |
| plan_type | any | Plan type, as in `search_plans` (e.g. 401k, dc, db). |
| filer_size | string | 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. |
| max_assets | any | Maximum end-of-year net assets in dollars. |
| min_assets | any | Minimum end-of-year net assets in dollars, in the plan's latest plan year. |
| recordkeeper | any | Only plans whose latest Schedule C names this recordkeeper (any brand, matched to its family as in `search_plans`). |
| include_ended | boolean | Include plans that are terminated, merged into another plan, or stopped filing. Off by default. |
| effective_after | any | Only plans whose effective (inception) date is on or after this date (YYYY-MM-DD). |
| effective_before | any | Only plans whose effective (inception) date is on or before this date (YYYY-MM-DD). |
| max_participants | any | Maximum end-of-year participants. |
| min_participants | any | Minimum end-of-year participants, in the plan's latest plan year. |
{
"name": "list_prospects",
"title": "Bulk list of plans by industry, place and size: address, industry, participants, assets, inception date, recordkeeper",
"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": {
"type": "object",
"title": "list_prospectsArguments",
"properties": {
"zip": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Zip",
"default": null,
"description": "Sponsor's ZIP code or its start (3-5 digits), e.g. 432 for the Columbus, OH area."
},
"city": {
"anyOf": [
{
"type": "string",
"maxLength": 60,
"minLength": 2
},
{
"type": "null"
}
],
"title": "City",
"default": null,
"description": "Sponsor's city, as on the filing (case doesn't matter). Best with `state`."
},
"sort": {
"enum": [
"assets",
"participants",
"name",
"newest_plan"
],
"type": "string",
"title": "Sort",
"default": "assets",
"description": "assets (largest first, the default), participants (most first), name (A-Z by sponsor) or newest_plan (latest effective date first)."
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 50,
"maximum": 100,
"minimum": 1,
"description": "Plans per page (1-100). The price is per call, whatever the limit."
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "State",
"default": null,
"description": "Two-letter state of the sponsor's address, e.g. OH."
},
"offset": {
"type": "integer",
"title": "Offset",
"default": 0,
"maximum": 500,
"minimum": 0,
"description": "Plans to skip (0-500)."
},
"industry": {
"anyOf": [
{
"type": "string",
"maxLength": 200,
"minLength": 2
},
{
"type": "null"
}
],
"title": "Industry",
"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."
},
"plan_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Plan Type",
"default": null,
"description": "Plan type, as in `search_plans` (e.g. 401k, dc, db)."
},
"filer_size": {
"enum": [
"large",
"small",
"any"
],
"type": "string",
"title": "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."
},
"max_assets": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Max Assets",
"default": null,
"description": "Maximum end-of-year net assets in dollars."
},
"min_assets": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Min Assets",
"default": null,
"description": "Minimum end-of-year net assets in dollars, in the plan's latest plan year."
},
"recordkeeper": {
"anyOf": [
{
"type": "string",
"maxLength": 100,
"minLength": 3
},
{
"type": "null"
}
],
"title": "Recordkeeper",
"default": null,
"description": "Only plans whose latest Schedule C names this recordkeeper (any brand, matched to its family as in `search_plans`)."
},
"include_ended": {
"type": "boolean",
"title": "Include Ended",
"default": false,
"description": "Include plans that are terminated, merged into another plan, or stopped filing. Off by default."
},
"effective_after": {
"anyOf": [
{
"type": "string",
"format": "date"
},
{
"type": "null"
}
],
"title": "Effective After",
"default": null,
"description": "Only plans whose effective (inception) date is on or after this date (YYYY-MM-DD)."
},
"effective_before": {
"anyOf": [
{
"type": "string",
"format": "date"
},
{
"type": "null"
}
],
"title": "Effective Before",
"default": null,
"description": "Only plans whose effective (inception) date is on or before this date (YYYY-MM-DD)."
},
"max_participants": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Max Participants",
"default": null,
"description": "Maximum end-of-year participants."
},
"min_participants": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Min Participants",
"default": null,
"description": "Minimum end-of-year participants, in the plan's latest plan year."
}
}
},
"annotations": {
"title": "Bulk list of plans by industry, place and size: address, industry, participants, assets, inception date, recordkeeper",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}