Quick Start

Get your first AgentBridge tool execution working in under 5 minutes. By the end of this guide you will have connected an integration and called a real provider tool from your terminal or application.

Prerequisites #

Steps #

1. Sign up at agentbridge.in

   Go to agentbridge.in/signup and create a free account. You will receive a verification email — click the link to activate your account before making API calls.

   Once logged in you will land on the Dashboard. This is your control panel for API keys, integrations, and execution logs.

2. Generate an API key

   In the Dashboard, navigate to API Keys in the left sidebar, then click Create API Key. Give it a name (e.g. my-agent-key) and select the write scope.

   ⚠️

   Your API key is shown only once. Copy it immediately and store it somewhere safe — a password manager or secrets manager. You will not be able to view the full key again after closing the dialog.

   Your key will look like this:

   text Copy

   ab_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

   All AgentBridge API keys begin with the prefix ab_live_. Keep this out of source control. See the Authentication guide for best practices.

3. Set up your environment

   Store your API key as an environment variable so you never hard-code it:

   .env Copy

   # AgentBridge API Key — never commit this file
   AGENTBRIDGE_API_KEY=ab_live_xxxxxxxxxxxxxxxxxxxx

   Add .env to your .gitignore. For production, use your platform's secret management (AWS Secrets Manager, Vercel Environment Variables, GitHub Secrets, etc.).

   If you plan to use the TypeScript SDK, install it now:

   bash Copy

   npm install agentbridge-sdk

4. Connect an integration

   Navigate to Integrations in the Dashboard sidebar. You will see all available providers. Click Connect next to Notion (or any provider you have an account with).

   An OAuth popup will open. Authorize AgentBridge to access your account. Once the popup closes, the integration will show as Active with a green indicator.

   AgentBridge stores your OAuth tokens encrypted with AES-256-GCM — they are never stored in plaintext and are decrypted only at execution time.

   Provider	Auth Type	What You Authorize	Setup Time
   Notion	OAuth 2.0	Read and write pages and databases you select	~30s
   Slack	OAuth 2.0	Post messages and read channel history	~30s
   GitHub	Personal Access Token	Repos, issues, and pull requests	~60s
   Google Drive	OAuth 2.0	Read and manage files	~30s
   Gmail	OAuth 2.0	Read and send email	~30s

5. Execute your first tool

   Now you are ready to call a real tool. The example below creates a new Notion page using the create_page tool. Replace ab_live_xxxx with your real key and your-page-id with a Notion page ID you have access to.

   Using curl #

   POST https://api.agentbridge.in/api/mcp/execute
   bash Copy

   curl -X POST https://api.agentbridge.in/api/mcp/execute \
     -H "Authorization: Bearer ab_live_xxxx" \
     -H "Content-Type: application/json" \
     -d '{
       "provider": "notion",
       "tool": "create_page",
       "params": {
         "parent_id": "your-page-id",
         "title": "My First Page"
       }
     }'

   A successful response looks like:

   json — 200 OK Copy

   {
     "status": "success",
     "data": {
       "id": "1a2b3c4d-...",
       "url": "https://notion.so/My-First-Page-1a2b3c4d",
       "title": "My First Page"
     },
     "latencyMs": 381,
     "executionId": "exec_01HXZ..."
   }

   Using the TypeScript SDK #

   typescript Copy

   import { AgentBridge } from 'agentbridge-sdk';
   
   const bridge = new AgentBridge(process.env.AGENTBRIDGE_API_KEY!);
   
   const result = await bridge.execute({
     provider: 'notion',
     tool:     'create_page',
     params: {
       parent_id: 'your-page-id',
       title:     'My First Page',
     },
   });
   
   console.log(result.data);
   // { id: '1a2b3c4d-...', url: 'https://notion.so/...' }

   ✅

   You're ready! You have just executed your first AgentBridge tool call. Your AI agent can now use the same execute call to interact with any connected provider — no separate OAuth flows, no provider-specific SDKs.

6. Try more providers

   The same pattern works for every provider. Here are examples for Slack and GitHub:

   Slack — Send a message #

   typescript Copy

   const slack = await bridge.execute({
     provider: 'slack',
     tool:     'send_message',
     params: {
       channel: 'C012AB3CD',
       text:    'Hello from AgentBridge!',
     },
   });
   // { ok: true, ts: '1234567890.123', channel: 'C012AB3CD' }

   GitHub — Create an issue #

   typescript Copy

   const issue = await bridge.execute({
     provider: 'github',
     tool:     'create_issue',
     params: {
       repo:   'my-org/my-repo',
       title:  'Bug: login page broken',
       labels: ['bug', 'priority:high'],
     },
   });
   // { id: 42, number: 157, url: 'https://github.com/...' }

7. View logs in the dashboard

   Every tool execution is automatically logged. Go to the Logs section in your Dashboard to see:

   • The provider and tool that was called
   • Request timestamp and end-to-end latency
   • Success or error status with full detail
   • Unique execution ID for debugging
   • Full provider error body if the call failed

   You can also query logs programmatically:

   bash Copy

   curl https://api.agentbridge.in/logs?page=1&limit=10 \
     -H "Authorization: Bearer ab_live_xxxx"

Troubleshooting #

Next Steps #