Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developer.happenstance.ai/llms.txt

Use this file to discover all available pages before exploring further.

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
create-credits-checkout-sessionPurchase 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.

​
Connect

The MCP URL is: 
https://happenstance.ai/mcp
Any MCP-compatible client can connect using this URL. You’ll be prompted to authenticate with your Happenstance account via OAuth. See the setup guides for specific clients:

ChatGPT

Official ChatGPT integration

Claude

Anthropic’s Claude assistant

Claude Code

Bring Happenstance where you develop

OpenClaw

Add the Happenstance skill

​
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?

Support

Contact our support team