Agent Access
Overview
This document is the technical contract between BRIDGE and AI agents. It supplements the Agent Policy (governance) with the implementation details needed to wire an agent into the protocol.
Agents access BRIDGE through one of: (a) the MCP server, (b) OpenAI plugin, (c) Microsoft Copilot plugin, (d) Google Gemini extension, (e) direct REST with the agent header set.
MCP Server
The canonical path. Install @bridge/mcp-server and point your MCP-capable client (Claude Desktop, Cursor, Continue, Windsurf) at it.
"bridge": { "command": "npx", "args": ["-y", "@bridge/mcp-server"], "env": { "BRIDGE_API_KEY": "sk_live_..." } }
OpenAI Plugin
Manifest at /static/.well-known/ai-plugin.json. OpenAPI spec at /static/.well-known/openapi.json. Installable in ChatGPT Custom GPTs and the OpenAI Agents SDK.
Copilot Plugin
Manifest at /static/.well-known/copilot-plugin.json. Compatible with Microsoft 365 Copilot and Copilot Studio. Requires admin approval in your tenant.
Gemini Extension
Manifest at /static/.well-known/gemini-extension.json. Works in Gemini Apps and AI Studio. Currently in beta — interface stable, documentation expanding.
Required Headers
| HEADER | REQUIRED | FORMAT |
|---|---|---|
Authorization | Always | Bearer sk_live_... |
X-BRIDGE-Agent | For agent calls | name/version; id=ag_... |
X-BRIDGE-Agent-Confirm | Tier 3 calls only | true |
X-BRIDGE-Trace-Id | Recommended | UUID, surfaces in audit log |
Exposed Tools
When integrating via MCP / plugin / extension, three tools are exposed:
bridge.verify(content, tier?, category?)— verify a content artifact.bridge.ask(query, force_tier?)— verified conversational answer.bridge.consensus.lookup(consensus_id)— retrieve audit detail for a prior result.
Agent-Specific Errors
| CODE | WHEN | RESOLUTION |
|---|---|---|
BRIDGE_AGENT_MISSING_HEADER | Agent call without X-BRIDGE-Agent | Add header per Section 06 |
BRIDGE_LOOP_DETECTED | Recursive verify of prior result | Reset chain depth or get human review |
BRIDGE_AGENT_CONFIRM_REQUIRED | Tier 3 from agent w/o confirm | Add X-BRIDGE-Agent-Confirm: true |
BRIDGE_AGENT_RATE_LIMITED | Above 1,000 agent verifications/hr | Enterprise plan for higher |
BRIDGE_AGENT_SUSPENDED | Agent identifier on suspension list | Contact abuse@getbridge.dev |