Product Introduction
- Definition: MCP Bridge by Appfactor is a self-hosted, protocol-agnostic server that automatically generates and serves Model Context Protocol (MCP) tool definitions from existing API schemas. It acts as a universal adapter, translating REST, GraphQL, SOAP, and gRPC APIs into a standardized, semantically rich interface for Large Language Model (LLM) agents and MCP-compatible clients.
- Core Value Proposition: It exists to eliminate the manual, time-consuming process of writing and maintaining individual MCP servers for each enterprise API. MCP Bridge enables organizations to securely and efficiently expose their entire API portfolio to AI agents with built-in governance, authentication, rate limiting, and token optimization, accelerating AI agent deployment from weeks to minutes.
Main Features
- Automated MCP Tool Generation: The core engine ingests API schemas—OpenAPI 3 (JSON/YAML), GraphQL introspection, WSDL, or gRPC .proto files—via URL or upload. It automatically parses each operation (e.g., GET /users, POST /order) and generates a fully described MCP tool with typed input/output JSON schemas, parameter mappings, and integrated documentation, ready for consumption by LLMs like Claude, GPT, or Gemini.
- Code Mode for Context Optimization: A unique feature that addresses LLM context window limitations. For large APIs with hundreds of endpoints, Code Mode replaces the full catalog of individual tool definitions with just three meta-tools (list, describe, execute). This reduces context window usage by approximately 98% (e.g., from ~48,000 tokens to ~960 tokens). The LLM discovers and orchestrates API calls on-demand by executing JavaScript within a secure, time-limited Boa sandbox runtime.
- Declarative Response Post-Processing: To prevent LLM context waste on verbose API responses, MCP Bridge applies per-tool declarative rules to transform payloads before sending them to the agent. Rules include unwrapping nested objects, selecting specific fields, excluding unnecessary data, limiting array sizes, sorting, flattening structures, and aggregating values. Custom JavaScript transformations can also be executed in the sandbox for complex logic.
- Enterprise-Grade Security & Governance: Supports a comprehensive suite of authentication mechanisms for backend APIs, including Bearer tokens, Basic Auth, API Keys, OAuth 2.0 (client credentials flow), and AWS Cognito SRP. The admin interface supports OIDC integration with providers like Entra ID, Okta, or Keycloak. Features include per-API token bucket rate limiting, configurable retry policies with exponential backoff, and health checks.
- AI-Observability & Tool Management: Provides an analytics dashboard tracking AI-specific metrics: per-tool and per-API latency, throughput, error rates, and detailed token usage breakdowns. Supports OpenTelemetry (OTel) export in the Enterprise tier. Allows tool curation—enabling/disabling, renaming, editing descriptions, and customizing parameter mappings. Includes semantic tool search using hybrid full-text, trigram fuzzy matching, and optional vector similarity via pgvector and HNSW indexing.
Problems Solved
- Pain Point: Legacy APIs lack the semantic context and structured tool definitions required for LLM consumption. Manually creating and maintaining hundreds of MCP servers for a diverse API landscape is a complex, error-prone, and unsustainable engineering burden that slows down AI agent development.
- Target Audience: Platform Engineering Teams needing to expose internal APIs to AI without building adapters; AI/ML Engineers building production agents that require reliable, governed API access; Enterprise Architects seeking to standardize on MCP (Model Context Protocol) across their organization without refactoring existing services.
- Use Cases: Enabling an AI customer support agent to query a SOAP-based CRM, update a RESTful order management system, and check inventory via a GraphQL API through a single MCP interface. Allowing a financial analysis agent to securely pull data from multiple internal gRPC microservices with automatic authentication and response filtering to stay within context limits.
Unique Advantages
- Differentiation vs. API Gateways: Unlike traditional API gateways that only route and secure HTTP traffic, MCP Bridge is built for AI agents. It adds a semantic layer: auto-generating tool definitions, annotating tools (read-only, idempotent, destructive), post-processing responses for token efficiency, and providing AI-specific observability (token usage, tool selection accuracy), which gateways do not offer.
- Key Innovation – Schema-to-Tool Intelligence: The system's ability to infer behavioral annotations and semantic context directly from API schema specifications (OpenAPI, GraphQL) and expose them as MCP metadata is a significant innovation. This, combined with the Code Mode sandbox approach for dynamic tool discovery, solves the fundamental tension between exposing full API capability and conserving precious LLM context windows.
Frequently Asked Questions (FAQ)
- What is MCP Bridge and how does it work with AI agents? MCP Bridge is a self-hosted server that automatically converts your existing REST, GraphQL, SOAP, and gRPC APIs into MCP (Model Context Protocol) tools. You point it at your API schema, and it generates a fully typed tool definition for each endpoint. AI agents like Claude or ChatGPT then connect to MCP Bridge as a standard MCP server, discovering and calling your enterprise APIs through a unified, semantically understood interface without any manual coding.
- How does MCP Bridge's Code Mode save LLM context tokens? Code Mode drastically reduces context window usage by replacing hundreds of individual MCP tool definitions with just three meta-tools. Instead of loading descriptions for every API endpoint, the LLM uses a "describe" tool to discover endpoints on-demand and an "execute" tool to run calls via JavaScript in a secure sandbox. This shifts the complexity from the prompt context to runtime execution, cutting token consumption by ~98%.
- Is my API data secure with MCP Bridge? Yes, MCP Bridge is designed for enterprise security. It is a self-hosted Docker container, meaning your data never leaves your network or cloud environment. It supports robust backend authentication (OAuth2, API Keys, etc.) and offers OIDC for the management UI. It has no external SaaS dependencies at runtime, giving you full control over data flow and access.
- Can MCP Bridge handle very large or complex API specifications? Absolutely. It is built in Rust for high-performance parsing and execution. For massive APIs, the recommended approach is to use Code Mode to avoid context bloat. The system efficiently handles OpenAPI, GraphQL, WSDL, and .proto files, and its declarative response processing rules are crucial for trimming large payloads before they are sent to the LLM, maintaining performance.
- What are the deployment options for MCP Bridge? MCP Bridge is distributed as a Docker container, offering flexible deployment. You can run it on any orchestrator like Kubernetes, AWS ECS, or Azure Container Apps. It is also available for one-click deployment via the AWS Marketplace and Microsoft Azure Marketplace, simplifying procurement and deployment in enterprise cloud environments.