Skip to main content
For Developers

Build AI agents that find and contact human experts.

Expert Sapiens exposes a native MCP server and REST API so your AI agent can search verified professionals, read full profiles, and send inquiries — all without any user login.

How it works

Three steps. No user login required on the end-user side.

1

Search

Query experts by category, location, language, or keyword. Get back a ranked list with profile and booking URLs.

2

Evaluate

Fetch the full profile — bio, services with pricing, weekly availability, and all public contact channels.

3

Contact

Submit an inquiry on behalf of your user. The expert is notified by email and replies directly — no platform friction.

MCP Quick Start

Add Expert Sapiens as a native tool to Claude, Cursor, Windsurf, or any MCP-compatible host. The MCP server is live at https://expertsapiens.com/api/mcp.

Claude Desktop — read only
// claude_desktop_config.json
{
  "mcpServers": {
    "expert-sapiens": {
      "url": "https://expertsapiens.com/api/mcp"
    }
  }
}
Claude Desktop — with API key
// claude_desktop_config.json — with API key (enables submit_inquiry)
{
  "mcpServers": {
    "expert-sapiens": {
      "url": "https://expertsapiens.com/api/mcp",
      "headers": {
        "Authorization": "Bearer es_live_..."
      }
    }
  }
}
Cursor / Windsurf
// .cursor/mcp.json
{
  "mcpServers": {
    "expert-sapiens": {
      "url": "https://expertsapiens.com/api/mcp",
      "headers": {
        "Authorization": "Bearer es_live_..."
      }
    }
  }
}
stdio bridge (mcp-remote)
// For stdio-only clients — bridges remote MCP via npx
{
  "mcpServers": {
    "expert-sapiens": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://expertsapiens.com/api/mcp"]
    }
  }
}

search_experts, get_expert, search_properties and get_property work without an API key. submit_inquiry, save_property, set_property_price_alert and list_my_saved_properties require a Bearer token. Generate a key →

MCP Tools

Eight tools exposed by the MCP server at /api/mcp: three for experts and five for SeoulHomes property listings.

search_expertsNo auth required

Search and filter verified experts by category, location, language, or keyword. Returns a ranked list with profile URLs and booking links.

qstring?Keyword across name, title, tagline
categorystring?legal · accounting · immigration · finance · ...
countrystring?ISO 3166-1 alpha-2 (e.g. US, KR)
languagestring?BCP 47 code the expert speaks
accepting_onlyboolean?Only experts accepting new clients
limitnumber?Max results (default 10, max 20)
get_expertNo auth required

Full profile for a single expert: bio, services with pricing, weekly availability schedule, and all public contact methods.

slugstringExpert's unique slug from search results
localestring?Locale for translated bio/title (en · ko · ja · zh · fr · de)
search_propertiesNo auth required

Search SeoulHomes listings in Seoul and the greater Seoul area by deal type, property type, district, price, size and features. Returns listing URLs, pricing, size, location and the listing realtor.

qstring?Keyword across title, building name, neighborhood
listing_typestring?rent · jeonse · sale · short_term · lump_sum
typestring?officetel · apartment · villa · house · studio
districtstring?Seoul gu, Korean or romanized (강남구, gangnam)
neighborhoodstring?Neighborhood name (partial match)
min_pricenumber?Minimum KRW (sale price, or deposit for rent/jeonse)
max_pricenumber?Maximum KRW (sale price, or deposit for rent/jeonse)
min_areanumber?Minimum area in m²
max_areanumber?Maximum area in m²
roomsnumber?Minimum number of bedrooms
petboolean?Only pet-friendly listings
parkingboolean?Only listings with parking
localestring?Locale for translated text (en · ko · zh · ja · ru · vi · uz)
sortstring?newest · price_asc · price_desc
limitnumber?Max results (default 10, max 20)
get_propertyNo auth required

Full detail for one listing: description, complete pricing, specs, features, building profile, photos and the listing realtor.

slugstringListing slug from search_properties or the listing URL
localestring?Locale for translated text (en · ko · zh · ja · ru · vi · uz)
submit_inquiryAPI key required

Send an inquiry to an expert on behalf of your user, or to a SeoulHomes listing's realtor by passing property_slug. The recipient is notified by email and can reply directly. Rate limit per account: 5 per expert and 20 in total per 24 h.

expert_slugstring?Target expert's slug (not needed with property_slug)
property_slugstring?SeoulHomes listing slug; sends to that listing's realtor
requester_namestringName of the person you represent
requester_emailstringEmail the expert should reply to
messagestringThe inquiry message (max 2000 chars)
contextobject?Optional metadata (source, session_id, …)
save_propertyAPI key required

Save or unsave a listing on the key owner's SeoulHomes account.

property_slugstringListing slug from search_properties or the listing URL
saveboolean?true to save (default), false to unsave
set_property_price_alertAPI key required

Turn price-change notifications for a listing on or off for the key owner.

property_slugstringListing slug from search_properties or the listing URL
enabledbooleantrue to turn alerts on, false to turn them off
list_my_saved_propertiesAPI key required

List the key owner's saved listings with their price-alert status.

localestring?Locale for translated text (en · ko · zh · ja · ru · vi · uz)

REST API

Same capabilities as the MCP server, available as plain HTTP.

Full spec: https://expertsapiens.com/api/openapi.json

GET/api/agents/expertsNo auth

Search experts

curl "https://expertsapiens.com/api/agents/experts?category=legal&language=ko&limit=5"
GET/api/agents/experts/{slug}No auth

Full expert profile

curl "https://expertsapiens.com/api/agents/experts/james-chae?locale=en"
POST/api/agents/inquiriesBearer token

Submit inquiry to expert

curl -X POST "https://expertsapiens.com/api/agents/inquiries" \
  -H "Authorization: Bearer es_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "expert_slug": "james-chae",
    "requester_name": "Sarah Kim",
    "requester_email": "[email protected]",
    "message": "I need advice on a US-Korea cross-border acquisition."
  }'

Get an API key

Sign in to Expert Sapiens, then go to your dashboard to generate an API key. Keys are free. submit_inquiry is limited to 5 inquiries per expert and 20 in total per 24 h per account, and requests are throttled per minute.

  1. 1. Sign in or create an account at expertsapiens.com
  2. 2. Go to Dashboard → Account → API Keys
  3. 3. Click "Generate Key" and name it after your app
  4. 4. Copy the key — it is shown only once