Skip to main content

Bridges

A bridge connects InstaMCP to one of your APIs.

When to Create a Bridge​

Create a bridge when you want the AI agent to call an API, such as:

  • Searching products.
  • Reading customer orders.
  • Creating support tickets.
  • Checking subscription status.
  • Updating records in your system.

Create a Bridge​

  1. Open Bridge.
  2. Select New Bridge.
  3. Enter a bridge name.
  4. Choose an API source:
    • Public OpenAPI URL.
    • Raw OpenAPI JSON.
  5. Add the target API base URL if InstaMCP cannot detect it from the spec.
  6. Submit the form.

OpenAPI URL​

Use this when your API documentation is available at a public URL, for example:

https://api.example.com/openapi.json

The URL must be reachable by InstaMCP.

Raw OpenAPI JSON​

Use this when your spec is not public or you want to paste a fixed version.

Before pasting:

  • Confirm the JSON is valid.
  • Confirm it includes the endpoints you want to expose.
  • Remove private examples or secrets.

Target API Base URL​

The target API base URL is where real API requests should be sent.

Example:

https://api.example.com/v1

If your OpenAPI document already contains the correct server URL, this field may be optional.

After Creation​

After the bridge is created, continue with: