AgentBridge Documentation

AgentBridge is a unified MCP (Model Context Protocol) gateway that lets AI agents talk to any integration — Notion, Slack, GitHub, Google Drive, and more — through a single secure API endpoint.

What is AgentBridge? #

Every MCP provider ships its own authentication flow, request format, and response shape. Connecting an AI agent to five tools means writing five different integrations, managing five sets of tokens, and handling five distinct error formats.

AgentBridge eliminates that complexity. Your agent calls one endpoint. AgentBridge handles OAuth, token refresh, request translation, error normalisation, and audit logging — for every provider — so you don't have to.

Your AI Agent  ──▶  AgentBridge Router  ──▶  Provider Adapter  ──▶  External API

Key Features #

How It Works #

1. Authenticate with AgentBridge

   Generate an API key in the dashboard. Pass it as a Bearer token or configure it per-workspace.

2. Connect a provider

   Users OAuth-connect a provider once (Notion, Slack, GitHub…). AgentBridge stores the encrypted token in its vault and refreshes it automatically.

3. Execute any tool

   Call POST /api/mcp/execute with the provider slug, tool name, and parameters. AgentBridge retrieves the token, calls the provider, and returns a normalised response.

4. Inspect execution logs

   Every call is logged. View latency, status, and full error detail in the dashboard or via GET /logs.

Execute a Tool #

Authorization: Bearer ab_live_xxxxxxxxxxxxxxxxxxxx
Content-Type:  application/json

{
  "provider": "notion",
  "tool":     "create_page",
  "params":  {
    "parent_id": "abc123",
    "title":     "Meeting Notes"
  }
}

{
  "status": "success",
  "data": {
    "id":  "page_456",
    "url": "https://notion.so/Meeting-Notes-page_456"
  },
  "latencyMs": 342
}

TypeScript SDK #

npm install agentbridge-sdk

import { AgentBridge } from 'agentbridge-sdk';

const bridge = new AgentBridge('ab_live_xxxxxxxxxxxxxxxxxxxx');

// Execute any tool through a single interface
const result = await bridge.execute({
  provider: 'github',
  tool:     'create_issue',
  params:  {
    repo:   'my-org/my-repo',
    title:  'Bug: login page broken',
    labels: ['bug', 'priority:high'],
  },
});

console.log(result.data);
// { id: 42, url: 'https://github.com/my-org/my-repo/issues/42' }

Supported Integrations #

View full provider docs, available tools, and OAuth setup guides on the Integrations page.

Authentication #

AgentBridge supports two auth methods for API calls:

Read the full Authentication guide to learn how to generate API keys, set scopes, and rotate credentials safely.

Plans & Limits #

Security #

• Token Encryption — All integration tokens are encrypted with AES-256-GCM at rest and decrypted only at call time.
• TLS everywhere — All data in transit is encrypted. HTTP is redirected to HTTPS.
• Audit Logging — Every tool execution is logged with full request context, actor identity, and result.
• Rate Limiting — Per-user and per-key limits protect against accidental flooding and abuse.
• No log leakage — Parameter values are stored only in encrypted execution logs, never in plaintext application logs.

Read the Security overview for the full details.