Wellspent
Menu
Discovery API

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 it's for

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.

What's in the API

The same structured layer behind find.wellspent.co.

  • GET /v1/advisors Paginated 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/specialties The list of specialties used to filter advisors.
  • GET /v1/audiences The list of client types (founders, physicians, HENRY, cross-border families, more).
  • GET /v1/openapi.json OpenAPI 3.1 spec. Drop into Swagger, Redoc, Postman, or your codegen pipeline.
How it works

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"
MCP server

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.

Credits & trust

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.

Get started

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.

Already have an account? Same form. We'll just send the sign-in link instead of creating a new account.