Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| BUILDBETTER_API_KEY | Yes | Personal API key – generate from BuildBetter dashboard | |
| BUILDBETTER_ENDPOINT | No | BuildBetter staging / prod GraphQL endpoint | https://api.buildbetter.app/v1/graphql |
Schema
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| recent-calls | Generate a GraphQL query to list the most recent calls (interviews) |
| call-details | Retrieve detailed information about a specific call by ID |
| call-transcript | Retrieve the full transcript for a specific call by ID |
| search-transcript | Search within a call transcript for a specific phrase |
| call-extractions | Retrieve extractions (signals) from a call, optionally filtered by type name |
| signal-frequency | Show how many extractions exist for each extraction type across all calls |
| feature-requests-by-date | List feature-request extractions across calls in a date range |
| explore-schema | Guide the user on how to explore the GraphQL schema using available tools/resources |
| recent-issues | Query the 20 most recent Issue-type extractions across all calls |
| feature-requests | Query the 20 most recent Feature Request extractions |
| top-customer-issues | Show the most recent Issue-type extractions with the related company name |
| recent-objections | List Objection-type extractions in a date range (defaults to last 30 days) |
| last-call-with-person | Return the most recent call the specified person attended (searches by first name) |
| context-guide | Open the BuildBetter GraphQL Context Guide resource |
| top-objections | Alias for recent-objections (past N days, default 30) |
| customer-objections | Objections voiced by customers within a time range (default 30 days) |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| GraphQL Schema Overview | List of all available object types in the schema. |
| BuildBetter Context Guide | Strategies, query patterns, and best practices for building rich context with BuildBetter GraphQL data. |
| Schema Relationships Cheat-Sheet | Markdown diagram of key entities and how they connect (interview, extraction, extraction_type, joins, person, company). |
| Common Query Examples | Ready-to-use GraphQL snippets for frequent BuildBetter data tasks. |
| Practical Query Examples | Ready-to-use examples for the most common scenarios with BuildBetter data |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| run-query | Execute a read-only GraphQL query |
| list-types | Get a list of available GraphQL object types (excluding internal ones) |
| build-query | Build a simple GraphQL query string for a specific type |
| schema-overview | Return a markdown cheat-sheet describing key schema relationships (mermaid diagram). |
| search-extractions | Search extractions (signals) by keyword/phrase with optional extraction type filter and limit |
| find-fields | Return the field names for a specified GraphQL type (object or input object) |
| open-resource | Fetch a static resource by URI returned from ListResources |
| read-resource | Alias of open-resource to fetch a static resource by URI |
| recent-conversation-with | Find the most recent conversation with a specific person by name |
| top-customer-issues | Get the most common customer issues from extractions/signals |
| topic-conversations | Find conversations discussing a specific topic |
| query-template | Generate a query from predefined templates for common tasks |
| validate-query | Check if a GraphQL query is valid before executing it |
| nl-query | Generate a GraphQL query from a natural language description |
| help | Get help on using BuildBetter MCP effectively |