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
find-more-resultsGet additional results for an existing search (guarantees different people)
research-personStart a detailed profile research on a person
get-research-resultsCheck status and retrieve a research profile
get-userGet your profile information and friends list
get-groupsList your Happenstance groups
get-groupGet group details and full member list
get-creditsCheck your credit balance and usage
get-checkoutPurchase credits via Stripe checkout
Search and research run asynchronously. Your AI assistant will call the start tool, then poll the results tool until complete.

​
Finding More Results

Each search returns up to 30 results. If more are available, the response includes has_more: true. Your AI assistant can call find-more-results to get additional people — this guarantees different results by excluding everyone already returned. Each find-more request costs 2 credits.

​
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”
  • “Find engineers @Sarah Chen knows in my YC group”
  • “Check my Happenstance credit balance”

​
Billing

MCP tool calls consume credits the same as direct API calls:
  • Search: 2 credits per search (including find-more requests)
  • 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