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 and get_expert work without an API key. submit_inquiry requires a Bearer token. Generate a key →

MCP Tools

Three tools exposed by the MCP server at /api/mcp and /api/sse.

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)
submit_inquiryAPI key required

Send an inquiry to a specific expert on behalf of your user. The expert is notified by email and can reply directly. Rate limit: 5 per expert per 24 h.

expert_slugstringTarget expert's slug
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, …)

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 and have no rate limit except on submit_inquiry (5 per expert per 24 h).

  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