Connect your AI agent - Bridge REST Integrations API & Webhooks

Overview

This documentation site publishes a search MCP server at https://docs.bridge.new/mcp. Connect it to your AI coding assistant and the assistant reads these pages directly — the REST API reference, the webhook events, the error codes — instead of relying on whatever it learned during training. The server is public and read-only. It needs no API Key and no configuration on your side beyond pointing your assistant at the URL.

This server reads documentation. It does not call the Bridge API.It searches and returns the pages of this site. It cannot create a contact, send a message, or read your workspace data. Your assistant still needs an API Key and your own code to call the Bridge API — see Authentication.

Connect your client

Claude Code
Cursor
Codex
VS Code
Claude

Run:

claude mcp add --transport http bridge-docs https://docs.bridge.new/mcp

Verify the connection with claude mcp list.

Press Command + Shift + P (Ctrl + Shift + P on Windows) to open the command palette.
Search for Open MCP settings.
Click Add custom MCP to open mcp.json.
Add the server:

{
  "mcpServers": {
    "bridge-docs": {
      "url": "https://docs.bridge.new/mcp"
    }
  }
}

In ~/.codex/config.toml, add:

[mcp_servers.bridge-docs]
url = "https://docs.bridge.new/mcp"

Create a .vscode/mcp.json file in your project and add:

{
  "servers": {
    "bridge-docs": {
      "type": "http",
      "url": "https://docs.bridge.new/mcp"
    }
  }
}

Go to the Connectors page in your Claude settings.
Click Add custom connector.
Enter bridge-docs as the name and https://docs.bridge.new/mcp as the URL.
Click Add.
In a conversation, click the attachments button and select the server.

What your assistant can do

Once connected, your assistant has three tools:

Tool	What it does
Search documentation	Searches these pages and returns matching content with links back to the source page.
Read pages	Reads whole pages, so the assistant can pull a full endpoint definition or event schema rather than a snippet.
Submit feedback	Reports a page that is wrong, outdated, or incomplete back to the Bridge team.

Your assistant decides when to use them based on your prompt. You do not need to ask it to search.

Example questions

Ask your assistant these in a project where you are integrating with Bridge:

Which header does the Bridge API use for authentication, and against which host?
Write a Python function that creates a contact in Bridge, using the required fields from the API reference.
Which webhook events does Bridge emit when a conversation changes, and what does each payload contain?
How do I verify the signature on an incoming Bridge webhook?
What does Bridge error code BRIDGE_CONVERSATION_0001 mean?

Scope and availability

The server returns what is published on this site. Pages that are not part of this site’s navigation are not indexed and cannot be retrieved.

The server is hosted by our documentation provider as part of this site. Treat it as best-effort: it has no separate uptime commitment, and it applies rate limits well above normal use. If a request fails, read the pages directly. If your assistant returns something that contradicts these pages, the pages are authoritative. Report it to support@sainapsis.com.

​Overview

​Connect your client

​What your assistant can do

​Example questions

​Scope and availability

Overview

Connect your client

What your assistant can do

Example questions

Scope and availability