> ## 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.

# MCP

> Connect Happenstance to AI assistants using the Model Context Protocol

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:

| Tool                              | Description                                                                 |
| --------------------------------- | --------------------------------------------------------------------------- |
| `search-network`                  | Search for people across your groups and connections                        |
| `get-search-results`              | Check status and retrieve results from a search                             |
| `find-more-results`               | Get additional results for an existing search (guarantees different people) |
| `research-person`                 | Start a detailed profile research on a person                               |
| `get-research-results`            | Check status and retrieve a research profile                                |
| `get-user`                        | Get your profile information and friends list                               |
| `get-groups`                      | List your Happenstance groups                                               |
| `get-group`                       | Get group details and full member list                                      |
| `get-credits`                     | Check your credit balance and usage                                         |
| `create-credits-checkout-session` | Purchase credits via Stripe checkout                                        |

<Note>
  Search and research run asynchronously. Your AI assistant will call the start tool, then poll the results tool until complete.
</Note>

### 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:

<CardGroup cols={2}>
  <Card title="ChatGPT" icon="message" href="/mcp/chatgpt">
    Official ChatGPT integration
  </Card>

  <Card title="Claude" icon="robot" href="/mcp/claude">
    Anthropic's Claude assistant
  </Card>

  <Card title="Claude Code" icon="terminal" href="/mcp/claude-code">
    Bring Happenstance where you develop
  </Card>

  <Card title="OpenClaw" icon="lobster" href="/mcp/openclaw">
    Add the Happenstance skill
  </Card>
</CardGroup>

## 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](https://happenstance.ai/integrations/keys) page.

## Need Help?

<CardGroup cols={1}>
  <Card title="Support" icon="life-ring" href="https://happenstance.ai/contact">
    Contact our support team
  </Card>
</CardGroup>