​
BuildBetter MCP Server - Complete Guide

This comprehensive guide covers everything you need to know about the BuildBetter MCP Server, from setup to advanced usage.

​
Overview

The BuildBetter MCP (Model Context Protocol) server provides secure, read-only access to BuildBetter’s GraphQL API, enabling AI assistants like Claude to query and analyze your customer conversation data, insights, and signals.

Read-Only Access

No data modifications possible

Remote Server

No local installation required

API Authentication

Secure API key protection

Real-time Data

Access current information

​
Getting Started

​
Prerequisites

  • Node.js v18 or higher installed on your system
  • A BuildBetter API key (see Getting Your API Key)
  • Claude Desktop or another MCP-compatible client

​
Check Your Node.js Version

node --version
If you see a version lower than v18, please update Node.js before continuing.

​
Setup Instructions

​
For Claude Desktop

1

Locate Configuration File

Find your Claude Desktop configuration file based on your operating system:
~/Library/Application Support/Claude/claude_desktop_config.json
2

Add BuildBetter Configuration

Add the BuildBetter MCP server to your configuration:
{
  "mcpServers": {
    "buildbetter": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.buildbetter.ai?apikey=YOUR_API_KEY_HERE"]
    }
  }
}
Replace YOUR_API_KEY_HERE with your actual API key.
3

Restart Claude Desktop

Completely quit and restart Claude Desktop for changes to take effect.
4

Verify Connection

Test the connection by asking Claude:
“Can you list the available BuildBetter tools?”

​
For Other MCP Clients

Test the connection using the official MCP Inspector:
npx @modelcontextprotocol/inspector@latest
Then connect to: https://mcp.buildbetter.ai?apikey=YOUR_API_KEY

​
Getting Your API Key

1

Email Support Team

Send an email to support@buildbetter.ai
2

Include Required Information

  • Your company name
  • Your BuildBetter account email
  • Intended use case (e.g., “Claude Desktop integration”)
3

Receive Your Key

You’ll receive your API key within 1-2 business days
API keys are tied to your BuildBetter organization and provide access to your organization’s data only.

​
What You Can Do

The BuildBetter MCP server enables AI assistants to:
  • Search recent calls and meetings
  • Find conversations by topic, participant, or date
  • Retrieve call summaries and transcripts
  • Search for specific types of feedback (issues, requests, praise)
  • Track sentiment trends
  • Identify patterns across multiple conversations
  • Look up customer and team member details
  • Find calls associated with specific people or companies
  • Track interaction history
  • Build custom reports combining multiple data sources
  • Identify trending topics across customer calls
  • Create summaries of customer feedback by theme

​
Use Cases

​
🎯 Customer Success Teams

Weekly Customer Health Reports

“Show me all critical issues mentioned by Enterprise customers in the last 7 days”

Account Reviews

“Find all conversations with Acme Corp and summarize their main pain points”

Churn Risk Analysis

“Identify customers who’ve expressed frustration in recent calls”

​
💼 Product Management

Feature Request Tracking

“List all feature requests mentioned in the last month, grouped by theme”

User Feedback Analysis

“Find all feedback about our onboarding process”

Competitive Intelligence

“Show mentions of competitors in customer calls”

​
🛠️ Engineering Teams

Bug Report Aggregation

“Find all technical issues mentioned by customers this week”

Integration Feedback

“Search for problems users are having with our API”

Performance Complaints

“List all mentions of slow performance or timeouts”

​
📊 Executive Leadership

Strategic Insights

“Summarize the top 5 themes from customer conversations this quarter”

Market Trends

“What new use cases are customers asking about?”

Customer Sentiment

“How has overall customer sentiment changed over the last 30 days?”

​
Common Queries

“Show me the 10 most recent customer calls”

​
Available Tools

The MCP server provides these tools to Claude:

run-query

Execute custom GraphQL queries

list-types

Explore available data types

build-query

Generate queries for specific data types

search-extractions

Search customer signals and feedback

find-fields

Discover fields available for each data type

​
Security & Privacy

​
🔒 Read-Only Access

  • The MCP server provides read-only access to your data
  • No mutations or data modifications are possible
  • All write operations are blocked at the server level

​
🔑 API Key Security

  • Each API key is tied to a specific BuildBetter organization
  • Keys only provide access to your organization’s data
  • Store your API key securely - treat it like a password
  • Never commit API keys to version control

​
🌐 Network Security

  • All connections use HTTPS encryption
  • Server hosted on Cloudflare’s secure infrastructure
  • No data is stored or cached by the MCP server

​
⚠️ Best Practices

1

Rotate keys periodically

Contact support for new keys
2

Limit key distribution

Only share with authorized team members
3

Monitor usage

Review Claude’s queries regularly
4

Report issues

Contact support if you suspect unauthorized access

​
Limitations

  • Read-only - Cannot create, update, or delete data
  • Organization-scoped - Access limited to your organization’s data
  • No bulk exports - Designed for targeted queries, not data dumps

​
Troubleshooting

​
Connection Issues

  1. Verify your Node.js version is v18+: node --version
  2. Check your API key is correct
  3. Ensure you have internet connectivity
  1. Verify you’ve replaced YOUR_API_KEY_HERE with your actual key
  2. Check for extra spaces or quotes around the key
  3. Confirm your key hasn’t been revoked

​
Claude Desktop Issues

  1. Ensure configuration file is valid JSON
  2. Restart Claude Desktop completely
  3. Check file permissions on the config file
  4. Look for syntax errors in the configuration
  1. Ensure Node.js is properly installed
  2. Check that npm/npx is in your system PATH
  3. Try using the full path to npx

​
Data Access Issues

  1. Verify you have data in your BuildBetter account
  2. Check date ranges in your queries
  1. Use the list-types tool to see available types
  2. Check for typos in type names
  3. Note that type names are case-sensitive

​
Support

​
Getting Help

API Keys & Account

Email support@buildbetter.ai
  • Include organization name
  • Include account email

Technical Issues

Check Troubleshooting first
  • Include error messages
  • Specify Node.js version and OS

​
Resources

MCP Protocol

Official documentation

API Reference

Technical details

Quick Start

5-minute setup
Last updated: January 2025
BuildBetter MCP Server v0.0.1