Power advisor discovery in the next crop of personal finance apps.
The same advisor data that AI assistants read is available to developers building personal finance products. Read access to fee-only advisor records, specialties, audiences, and geographies. Self-serve, pay-as-you-go credits.
Who builds with this.
Personal finance apps
You're building the product where users consolidate their money. When someone asks "who should I talk to?", a structured match beats a directory listing.
AI assistants and agents
Your assistant answers complex personal-finance questions. When the right answer is a fee-only advisor with a specific specialty, our API returns the structured record your model can cite.
Fintech tooling and CRMs
You're building the developer infrastructure that other wealth-tech runs on. Verify advisor records, enrich profile data, or check fee-only status against official sources.
The same structured layer behind find.wellspent.co.
-
GET /v1/advisorsPaginated search by country, region, specialty, audience, and free-text query. -
GET /v1/advisors/{slug}The full profile for one advisor: bio, fee models, fiduciary status, credentials, and the advisor's own description of their ideal client (high-signal input for matching agents). -
GET /v1/specialtiesThe list of specialties used to filter advisors. -
GET /v1/audiencesThe list of client types (founders, physicians, HENRY, cross-border families, more). -
GET /v1/openapi.jsonOpenAPI 3.1 spec. Drop into Swagger, Redoc, Postman, or your codegen pipeline.
Authenticate, search, render.
1. Sign in & top up
Enter your email, click the link we send, top up $10 (or more). Credits land in your account immediately. Mint as many keys as you need from the dashboard.
2. Authenticate
Pass Authorization: Bearer wsk_live_… on every
request. Each call costs 1 credit.
3. Read
Search and fetch advisor records. Cursor-paginated, JSON responses, predictable error envelope.
Search advisors
Paginated list. Filter by country, region, specialty, audience, or free-text query.
curl https://api.wellspent.co/v1/advisors \
-H "Authorization: Bearer wsk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
-G \
--data-urlencode "country=us" \
--data-urlencode "region=california" \
--data-urlencode "specialty=equity-compensation" Example response
{
"data": [
{
"slug": "jane-reyes",
"name": "Jane Reyes, CFP",
"credentials": ["CFP", "MBA"],
"firm": "Bridgestone Planning",
"location": {
"country": "us",
"region": "California",
"region_slug": "california",
"city": "Palo Alto"
},
"is_fiduciary": true,
"specialties": ["Equity compensation", "Founders (pre-exit)"],
"audiences": ["Tech employees", "Founders"],
"fee_models": ["Flat Fee/Retainer"],
"founded_year": 2018,
"profile_url": "https://find.wellspent.co/advisors/jane-reyes/",
"status": "claimed"
}
],
"pagination": {
"limit": 25,
"next_cursor": "jane-reyes",
"has_more": true
}
} Fetch one advisor by slug
Returns the full profile, including the advisor's ideal-client narrative.
curl https://api.wellspent.co/v1/advisors/jane-reyes \
-H "Authorization: Bearer wsk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" List specialties
Use the returned slugs as the specialty param in advisor search.
curl https://api.wellspent.co/v1/specialties \
-H "Authorization: Bearer wsk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" List client types
Founders, physicians, HENRY, cross-border families, and the rest of the list.
curl https://api.wellspent.co/v1/audiences \
-H "Authorization: Bearer wsk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" Connect an AI assistant directly.
Claude, ChatGPT, and other MCP clients can query fee-only advisor matches through our public, read-only Model Context Protocol server. No key and no credits. Limited to 60 requests per minute per IP.
https://api.wellspent.co/mcp search_fee_only_advisors
Ranked matches by country, region, city, specialties, audiences, and virtual_ok. Each result says why it matched and whether the advisor maintains the profile.
get_advisor_profile
One advisor's public profile by slug: their own profile if they're a member, otherwise directory facts plus public enrichment.
list_specialties_and_audiences
The specialty, audience, and region slugs that search accepts.
claude.ai and Claude Desktop
Settings → Connectors → Add custom connector. Name it Wellspent and paste the URL above. To use a config file instead, add this to claude_desktop_config.json (it bridges through mcp-remote):
{
"mcpServers": {
"wellspent": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://api.wellspent.co/mcp"]
}
}
} Claude Code
claude mcp add --transport http wellspent https://api.wellspent.co/mcp Raw JSON-RPC
Streamable HTTP, stateless, JSON responses. There are no sessions, so tools/call works without calling initialize first.
curl -X POST https://api.wellspent.co/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{
"name":"search_fee_only_advisors",
"arguments":{"country":"us","region":"california",
"specialties":["equity-compensation"],"limit":3}}}' Results include the attribution "Source: Wellspent, find.wellspent.co" and link to each advisor's page on find.wellspent.co.
Built for production.
1 credit per call
Every endpoint costs the same. No tiering, no surprise overages, no per-field surcharges.
No subscription
Top up when you need to. Bigger packs earn bonus credits. Pay only for what you use.
Versioned + stable
Versioned URL path, deprecation warnings via response header, no breaking changes mid-version.
Read-only, public-projection
The API exposes the same data published at find.wellspent.co. Member-private fields never cross the boundary.
Attribution required
Apps using the API surface advisor profile links back to find.wellspent.co. Keeps trust circulating in the graph.
Credits don't expire
Top up once, draw down over months or years. Balance carries forward indefinitely.
Sign up. Top up. Build.
Self-serve. We email you a sign-in link, you top up credits via Stripe, then mint as many API keys as you need from the dashboard. Pay only for what you use.