> ## Documentation Index
> Fetch the complete documentation index at: https://docs.buildbetter.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# BuildBetter MCP Server

> Access your BuildBetter data directly from Claude, ChatGPT, Cursor, and other AI assistants

# BuildBetter MCP Server

<Card>
  <p className="text-lg">
    The BuildBetter MCP Server lets AI assistants like Claude and ChatGPT securely access your BuildBetter data — your calls, customer signals, contacts, and more. Interactive clients use BuildBetter OAuth sign-in, while unattended automation can use an organization API key in the `X-BuildBetter-Api-Key` header.
  </p>
</Card>

## Guides

<CardGroup cols={2}>
  <Card title="Quick Start" icon="rocket" href="/pages/MCP/quick-start">
    **2 minutes**
    Add the server URL to your AI client, sign in, and start asking questions.
  </Card>

  <Card title="Complete Guide" icon="book-open" href="/pages/MCP/complete-guide">
    **15-20 minutes**
    Setup for all clients, what you can ask, use cases by team, security, and troubleshooting.
  </Card>

  <Card title="Tool Reference" icon="wrench" href="/pages/MCP/tool-reference">
    Complete reference for MCP tools — parameters, examples, workflows, and signal schema.
  </Card>
</CardGroup>

## What Can You Do With It?

Once connected, you can ask your AI assistant questions about your BuildBetter data in plain language:

* **"Show me all customer issues from the last week"**
* **"Summarize feedback from Acme Corp"**
* **"What feature requests came up this month?"**
* **"Which customers mentioned competitors recently?"**
* **"Show me Inbox items that are ready to promote"**
* **"Find Linear issues related to onboarding and prepare the ones that need approval"**

Your assistant handles the data fetching behind the scenes — you just ask questions.

## Product Ops Capabilities

The MCP server includes tools for product-ops workflows across Projects Hub, Inbox, folders, Linear, and signal search. Depending on your permissions, an MCP client can:

* View projects, project details, and related evidence
* Review Inbox items, backlog counts, folders, and folder details
* Discover Linear issues that match product work
* Search signals with natural-language queries
* Request approval before promoting Inbox items or selected Linear tickets into Projects Hub projects

<Info>
  Approval-based actions follow BuildBetter permissions. Your assistant can prepare an action, but promotion-style changes require explicit approval where the client supports it.
</Info>

## Need Help?

<Tabs>
  <Tab title="Quick Help">
    * **Setup issues?** Check the [Quick Start Guide](/pages/MCP/quick-start)
    * **Need details?** See the [Complete Guide](/pages/MCP/complete-guide)
  </Tab>

  <Tab title="Contact Support">
    Email [support@buildbetter.ai](mailto:support@buildbetter.ai) for:

    * Technical assistance
    * Feature requests
  </Tab>
</Tabs>

## Useful Links

<CardGroup cols={2}>
  <Card title="MCP Server" icon="server" color="#5D5D5D">
    `https://mcp.buildbetter.app/mcp`
  </Card>

  <Card title="MCP Protocol" icon="book" href="https://modelcontextprotocol.io">
    Official MCP docs
  </Card>
</CardGroup>

***

<Note>
  Last updated July 2026
</Note>