MarketBetter MCP
Connector guide

Connect MarketBetter to your AI assistant.

Add the hosted MarketBetter MCP server to any compatible client, approve access with OAuth, and work with your GTM data in natural language.

Before you connect

What you need

A compatible AI client

A client that supports remote Streamable HTTP MCP servers and OAuth.

A MarketBetter account

An active account connected to the workspace you want the assistant to use.

The right permissions

Your existing workspace role determines which records and actions are available.

Setup

Connect in four steps

  1. 1

    Open your client’s connector settings

    Look for Connectors, Integrations, or MCP servers. Choose the option to add a custom remote server.

  2. 2

    Add the MarketBetter endpoint

    Paste the endpoint below as a remote Streamable HTTP server. No API key or local command is required.

    https://mcp.marketbetter.ai/mcp
  3. 3

    Sign in to MarketBetter

    Your browser opens the MarketBetter OAuth flow. Sign in with your normal account and approve the connection.

  4. 4

    Start with a read-only request

    Ask the assistant to list or summarize something already in your workspace before creating or changing data.

Do not paste a MarketBetter API key into the connector URL or configuration. The public connector authenticates through the browser-based OAuth flow.

Your first request

Begin by reading, not writing

A read-only prompt confirms that the connection, workspace, and permissions are correct before the assistant prepares any changes.

List my active workflows and summarize their status.

Show the target accounts with the strongest recent intent and explain why.

Find the API operation for creating an audience, but do not create anything yet.

How the tools work

Three tools. The live product surface.

The assistant discovers the right MarketBetter operation, inspects its exact contract, and then makes the authenticated call.

Read-only
swagger_discover

Find the operation

Searches the live MarketBetter API catalog by goal, keyword, path, summary, or product area.

Read-only
swagger_inspect

Check the contract

Reads the exact parameters, request body, response shape, and examples for an operation.

Read + write
api_call

Do the work

Calls the authenticated operation—GET by default, or an explicit write method when requested.

Permissions and safety

Your role remains the boundary

  • Every request uses the connected user’s OAuth token and workspace permissions.
  • api_call defaults to GET. A write requires an explicit POST, PUT, PATCH, or DELETE method.
  • api_call is marked as potentially destructive so compliant clients can request approval before calls.
  • The MarketBetter API rejects operations that fall outside the user’s workspace role.
  • Authentication secrets and internal diagnostic identifiers are removed from tool results.

Disconnect and support

Remove MarketBetter from your AI client’s connector settings to disconnect it. For help with setup, permissions, or revoking access, contact MarketBetter support.