Skip to main content
The Happenstance MCP lets AI assistants search your network, research people and work with Happenstance Chat 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:
Search, research and Chat 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.

​
Working With Chat

Your AI assistant can hand Happenstance Chat goals that need several steps or judgment, such as finding investors who know someone you know and drafting intro requests. Chat keeps the conversation, so your assistant can continue a chat with follow-ups. A chat started over MCP has no scheduled tasks: for recurring results, ask your assistant to send the chat a message on a schedule.

​
Connect

The MCP URL for most clients is:
For the Claude-optimized integration, use:
Both endpoints authenticate with your Happenstance account via OAuth. Use the client-specific setup guides below for the recommended URL and configuration. 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”
  • “Ask Happenstance Chat who we know that would make a great angel investor for us”
  • “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
  • Chat: Chat turns have variable cost depending on how much work is done, often 1–3 credits. Each turn is charged when it finishes.
The get-credits tool reports your auto-reload status and links to your Settings page. Checkout-session creation is available in supported clients.

​
Need Help?

Support

Contact our support team