MCP Server

The HumanConnection MCP server exposes all platform tools through the Model Context Protocol via Streamable HTTP. This is the fastest way to give your AI agent access to people search and the full meeting lifecycle.

Endpoint

https://mcp.humanconnection.sh/mcp

The server supports the MCP Streamable HTTP transport — POST for requests, GET for SSE streaming, DELETE to close sessions.

Configuration

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

1 {
2   "mcpServers": {
3     "humanconnection": {
4       "type": "streamable-http",
5       "url": "https://mcp.humanconnection.sh/mcp"
6     }
7   }
8 }

Cursor

Add to .cursor/mcp.json in your project root:

1 {
2   "mcpServers": {
3     "humanconnection": {
4       "type": "streamable-http",
5       "url": "https://mcp.humanconnection.sh/mcp"
6     }
7   }
8 }

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

1 {
2   "mcpServers": {
3     "humanconnection": {
4       "type": "streamable-http",
5       "url": "https://mcp.humanconnection.sh/mcp"
6     }
7   }
8 }

Available tools

search_humans (Live)

Search for a person by name (with optional company/location context) or find people by location and title filters. Returns social profiles, bio, location, email, and confidence.

Person lookup mode:

Name	Type	Required	Description
`name`	string	Yes	Full name of the person to search for
`company_name`	string	No	Company name to help identify the right person (e.g. “Airbnb”)
`company_domain`	string	No	Company domain for precise matching (e.g. “airbnb.com”)
`location`	string	No	Location to narrow results (e.g. “San Francisco”)
`provide_email`	boolean	No	Set to `true` to include the person’s email in results

People search mode:

Name	Type	Required	Description
`location`	string	Yes	Location to search in (e.g. “Austin”, “New York”)
`title_filters`	string	Yes	Boolean filter for job titles (e.g. `"sales AND SaaS"`, `"engineer OR developer NOT intern"`)
`provide_email`	boolean	No	Set to `true` to include email addresses in results

Validation: provide either name OR (location + title_filters), not both.

Returns: Array of Human objects with name, email?, company_domain?, bio, location, profiles, and confidence.

search_interests (Live)

Search a person’s recent social activity for personal interests, hobbies, and conversation starters.

Parameters:

Name	Type	Required	Description
`name`	string	Yes	Full name of the person
`linkedin_url`	string	No	LinkedIn profile URL for activity scanning
`x_url`	string	No	X/Twitter profile URL for recent tweets
`instagram_url`	string	No	Instagram profile URL for recent posts

Returns: { signals: [{ source: "linkedin"|"x"|"instagram"|"web", signal: string }] }

search_events (Live)

Search for relevant events nearby where meetings can take place.

Parameters:

Name	Type	Required	Description
`location`	object	Yes	`{ lat, lng }` or `{ city }`
`radius_km`	number	No	Search radius in km (default 25)
`category`	string	No	Event category (e.g. “conference”, “meetup”)
`date_after`	string	No	ISO 8601 datetime filter
`date_before`	string	No	ISO 8601 datetime filter

search_places (Live)

Search for restaurants, cafes, golf, tennis/padel, galleries, museums, stadiums, bars.

Parameters:

Name	Type	Required	Description
`location`	object	Yes	`{ lat, lng }` or `{ city }`
`type`	string	Yes	`restaurant`, `cafe`, `golf`, `tennis`, `padel`, `gallery`, `museum`, `stadium`, `bar`
`radius_km`	number	No	Search radius in km (default 10)
`min_rating`	number	No	Minimum TripAdvisor rating 1-5 (restaurants only)

search_tickets (Live)

Find where to buy tickets for events across ticketing platforms.

Parameters:

Name	Type	Required	Description
`event_name`	string	Yes	Name of the event or match
`city`	string	No	City where the event takes place
`date`	string	No	Date of the event

book_ticket (Live)

Parameters:

Name	Type	Required	Description
`event_url`	string	Yes	URL of the event page to register for
`email`	string	Yes	Email address for registration
`name`	string	Yes	Full name for registration
`phone`	string	No	Phone number (required by some platforms)

send_meeting_invite (Planned)

Send Google Calendar invite to all participants via gcalcli. The invite is the booking.

Parameters:

Name	Type	Required	Description
`title`	string	Yes	Calendar event title
`attendee_emails`	string[]	Yes	Email addresses of all participants
`scheduled_at`	string	Yes	ISO 8601 datetime for the meeting start
`duration_minutes`	number	No	Duration in minutes (default 30)
`location`	string	No	Meeting location (venue name and/or address)
`description`	string	No	Calendar event description (agenda, talking points)

send_meeting_report (Planned)

Submit a report after a meeting has taken place.

Parameters:

Name	Type	Required	Description
`meeting_id`	string	Yes	Meeting ID (prefixed with `mtg_`)
`transcript`	string	No	Full or partial meeting transcript
`audio_url`	string	No	URL to audio recording
`summary`	string	Yes	Summary of what happened
`outcome`	string	Yes	`deal_closed`, `follow_up_needed`, `not_interested`, `no_show`
`deal_value`	object	No	`{ amount, currency }` if a deal was closed
`next_steps`	string	No	Recommended next steps

send_meeting_payment (Planned)

Create a reward payment for a human who completed a meeting.

Parameters:

Name	Type	Required	Description
`meeting_id`	string	Yes	Meeting ID (prefixed with `mtg_`)
`amount`	number	Yes	Reward amount
`currency`	string	Yes	ISO 4217 currency code (e.g. “USD”)
`type`	string	Yes	`commission`, `flat_fee`, or `bonus`
`note`	string	No	Note explaining the reward

REST API

All tools are also available as REST endpoints at api.humanconnection.sh:

GET  https://api.humanconnection.sh/api/v0          → tool index
POST https://api.humanconnection.sh/api/v0/{tool}   → call a tool

Example:

$ curl -X POST https://api.humanconnection.sh/api/v0/search_humans \
>   -H "Content-Type: application/json" \
>   -d '{"name": "Brian Chesky", "company_domain": "airbnb.com"}'

Tool annotations

Each tool includes MCP annotations that help agents understand tool behavior:

Annotation	Description
`readOnlyHint`	Tool only reads data (e.g. `search_humans`)
`destructiveHint`	Tool could destroy data (none currently)
`idempotentHint`	Calling multiple times produces the same result
`openWorldHint`	Tool interacts with external systems (e.g. `search_humans` queries the web)

Next steps

CLI

Use HumanConnection from the command line.

Skills

Install as a skill for Claude Code, Cursor, or Codex.