Skip to main content
The Happenstance MCP lets AI assistants search your network and research people on your behalf. It works with any client that supports the Model Context Protocol.

​
What You Can Do

Once connected, your AI assistant can use these tools:
ToolDescription
search-networkSearch for people across your groups and connections
get-search-resultsCheck status and retrieve results from a search
research-personStart a detailed profile research on a person
get-research-resultsCheck status and retrieve a research profile
get-groupsList your Happenstance groups
get-creditsCheck your credit balance and usage
Search and research run asynchronously. Your AI assistant will call the start tool, then poll the results tool until complete.

​
Setup

The MCP URL is: 
https://happenstance.ai/mcp
You’ll be prompted to sign in with your Happenstance account when you first connect.
  1. Open Claude and go to Settings
  2. Navigate to the Connectors page
  3. Click Add custom connector
  4. Enter Happenstance as the name and https://happenstance.ai/mcp as the URL
  5. Click Add
  6. Click Connect to log in to your Happenstance account

​
Example Usage

Once connected, you can ask your AI assistant things like:
  • “Search my network for people who work in AI infrastructure”
  • “Research Garry Tan, CEO of Y Combinator”
  • “Find engineers in my YC group who have experience with distributed systems”
  • “Check my Happenstance credit balance”

​
Billing

MCP tool calls consume credits the same as direct API calls:
  • Search: 2 credits per search
  • Research: 1 credit per completed research
Purchase credits from your Settings page.

​
Need Help?

API Reference

View the full API documentation

Support

Contact our support team