{"name":"KeepUp","version":"1.2.0","description":"KeepUp's public tools. Given a household net worth in USD and a country (and optionally an age), they return the wealth percentile, the thresholds for the median and the top 25/10/5/1%, and net worth by age, from national wealth surveys; and how KeepUp users compare, by country and age band, as rounded group figures. No personal or account information is available here.","protocol":{"name":"Model Context Protocol","version":"2025-06-18","transport":"streamable-http","endpoint":"https://api.keepup.finance/mcp/connector","method":"POST","stateless":true,"authentication":"none"},"tools":[{"name":"net_worth_percentile","description":"Given a household net worth in USD and a country (and optionally the age of the household head), return the wealth percentile it falls in and the 'top X%'. Answers questions like 'what percentile is a $500k net worth in Germany', 'is $1M a lot in Japan' or 'is $200k good at 30 in the US'. Public aggregate data, no personal or account information.","inputSchema":{"type":"object","properties":{"net_worth_usd":{"type":"number","description":"Household net worth in US dollars.","exclusiveMinimum":0},"country":{"type":"string","description":"ISO 3166-1 alpha-2 country code (e.g. US, DE, JP) or 'WORLD'. Omit for the worldwide distribution."},"age":{"type":"integer","minimum":18,"maximum":120,"description":"Optional age of the household head: ranks the net worth among households of that age group in the country (needs a country)."}},"required":["net_worth_usd"]},"title":"Net worth percentile","annotations":{"title":"Net worth percentile","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"rest_equivalent":"GET https://api.keepup.finance/public/net-worth-percentile?net_worth_usd=250000&country=DE"},{"name":"country_net_worth_thresholds","description":"Return the household net worth (USD) needed to reach the median and the top 25%, 10%, 5%, and 1% in a given country. Use for 'what net worth is top 1% in the UK' or to build a wealth-distribution table. Public data.","inputSchema":{"type":"object","properties":{"country":{"type":"string","description":"ISO 3166-1 alpha-2 country code (e.g. US, DE, JP) or 'WORLD'."}},"required":["country"]},"title":"Net worth thresholds by country","annotations":{"title":"Net worth thresholds by country","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"rest_equivalent":"GET https://api.keepup.finance/public/countries/DE/net-worth-thresholds"},{"name":"net_worth_by_age","description":"Household net worth by age of the household head in a country: the median and the top 10% and top 1% cutoffs for each age group (under 35, 35 to 44 … 75 or older). Pass an age to single out its group. Use for 'what is the average net worth at 30', 'top 1% net worth at 40 in the US' or 'median net worth by age in Germany'. US medians are the Federal Reserve's; other countries are labeled estimates.","inputSchema":{"type":"object","properties":{"country":{"type":"string","description":"ISO 3166-1 alpha-2 country code (e.g. US, DE, JP)."},"age":{"type":"integer","minimum":18,"maximum":120,"description":"Optional age: marks the age group it falls in."}},"required":["country"]},"title":"Net worth by age","annotations":{"title":"Net worth by age","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"rest_equivalent":"GET https://api.keepup.finance/public/countries/US/net-worth-by-age?age=30"},{"name":"list_supported_countries","description":"List every country KeepUp has wealth-distribution data for, with whether it has full survey breakpoints (higher precision at the tails). Call this to discover valid country codes.","inputSchema":{"type":"object","properties":{}},"title":"Supported countries","annotations":{"title":"Supported countries","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"rest_equivalent":"GET https://api.keepup.finance/public/countries"},{"name":"keepup_users_net_worth","description":"How KeepUp users compare: net worth at the 25th, 50th, 75th and 90th percentiles and the asset class most of them are led by, worldwide or in one country, optionally within an age band. Rounded group figures over users on KeepUp's public leaderboard (groups of five or more), never an individual. A self-selected group, not a whole country's population.","inputSchema":{"type":"object","properties":{"country":{"type":"string","description":"ISO 3166-1 alpha-2 country code (e.g. US, DE) or 'WORLD'. Omit for WORLD."},"age_band":{"type":"string","enum":["18-24","25-34","35-44","45-54","55-64","65+"],"description":"Optional age band."}}},"title":"How KeepUp users compare","annotations":{"title":"How KeepUp users compare","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"rest_equivalent":"GET https://api.keepup.finance/public/countries/US/members?age_band=25-34"}],"connect":{"claude_code":"claude mcp add --transport http keepup https://api.keepup.finance/mcp/connector","any_mcp_client":"Add a remote MCP server (Streamable HTTP) at https://api.keepup.finance/mcp/connector. No token, no OAuth, no session id.","curl":"curl -X POST https://api.keepup.finance/mcp/connector -H 'Content-Type: application/json' -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/list\"}'"},"example_call":{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"net_worth_percentile","arguments":{"net_worth_usd":250000,"country":"DE"}}},"data":{"scope":"Aggregate published wealth-survey figures and rounded group figures over KeepUp users on the public leaderboard (groups of five or more). No personal or account data is reachable here.","currency":"USD","as_of":"National wealth surveys 2021–2022 and the UBS Global Wealth Databook 2023.","methodology":"Household net worth in USD. Percentiles come from a log-normal fit to national wealth surveys (US Fed SCF, ECB HFCS, national statistical offices, UBS). Treat figures as close estimates, not to-the-dollar values."},"links":{"docs":"https://keepup.finance/mcp.md","privacy_policy":"https://keepup.finance/privacy","support":"support@keepup.finance","public_api":"https://api.keepup.finance/public/","openapi":"https://api.keepup.finance/public/openapi.json","llms_txt":"https://keepup.finance/llms.txt","site":"https://keepup.finance/"}}