Kaiva Bridge

Kaiva Bridge

Kaiva Bridge turns your API, database or documents into a managed MCP server that Claude, ChatGPT, Cursor, VS Code and other AI clients can use. This page covers the Kaiva Bridge connector, ai.kaiv/bridge, first; the command-line tool follows.

Kaiva Bridge as an MCP connector (ai.kaiv/bridge)

Kaiva Bridge is also an MCP server itself, so your AI client can create and manage MCP servers from inside a chat. It is listed in the official MCP Registry as ai.kaiv/bridge and in Claude's connector directory.

• Address: https://api.kaiv.ai/api/bridge/manage/mcp (Streamable HTTP)
• Sign-in: OAuth 2.1 with your Kaiva Bridge account (free, no card). No key to copy.
• Tools: list_my_servers, get_server, create_server (drafts a server from an OpenAPI spec URL) and reintrospect_server (refreshes a server's tools when the API changes).

The connector drafts and lists. Publishing a server and switching its tools on happen in the console, by you.

VS Code and GitHub Copilot: click Add to VS Code on kaiv.ai/bridge, or run *MCP: Add Server* in VS Code with the address above, then sign in when asked. Claude: claude.ai/directory/kaiva-bridge. Claude Code: claude mcp add --transport http --scope user kaiva-bridge https://api.kaiv.ai/api/bridge/manage/mcp. Cursor and ChatGPT: the Add menu on kaiv.ai/bridge.

Then ask: "List my Kaiva Bridge servers" or "Create a Kaiva Bridge server from https://petstore3.swagger.io/api/v3/openapi.json".

The command-line tool

Publish any API or database as a live MCP server, from your terminal.

Kaiva Bridge turns an OpenAPI spec, a database (PostgreSQL, MySQL, MariaDB or SQL Server) or a remote MCP server into a managed MCP server your agents can call. This CLI drives it over the Management API. Every setup command is safe to run again.

For your coding agent

Connect your AI agent to APIs, databases and documents with Kaiva Bridge. Install the skill so your coding agent can set up managed MCP connections for you. Try public APIs without an account.

Works with Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot and other compatible coding agents.

npx skills add ai-kaiva/bridge

Install

Nothing to install. Node 18+ has everything:

npx @kaiva/bridge help

Try it with no account

For a public API spec, one command gives you a working MCP server. No account, no login:

npx @kaiva/bridge try --openapi https://petstore3.swagger.io/api/v3/openapi.json

You get the server's address, a key for that one server, and a claim link. The server offers only the spec's GET operations, and lasts 72 hours or 500 calls. Open the claim link to keep it in your workspace: it keeps its address and your plan's limits apply. The key stops working at claim, so connect your AI client again from the console. Then you can add an API key and switch on other operations. Coding agents can do this themselves (--json prints one JSON object).

In a cloud agent sandbox (Codex cloud, Claude Code on the web), allow the domains api.kaiv.ai and registry.npmjs.org first: their network access is off or limited by default.

Claude Code plugin

claude plugin marketplace add ai-kaiva/bridge

claude plugin install kaiva-bridge@kaiva

Or copy just the skill: npx @kaiva/bridge skill install.

Postgres on your machine, no account

For a Postgres database that only the AI clients on your machine use, Kaiva Postgres MCP is a free, open-source MCP server that runs locally and only reads. It replaces the archived @modelcontextprotocol/server-postgres: change the package name and nothing else changes.

claude mcp add postgres -- npx -y @kaiva/postgres-mcp postgresql://localhost/mydb

or, from the same plugin marketplace as above (reads DATABASE_URL from your environment)

claude plugin install postgres-mcp@kaiva

When you need the same database in Claude.ai or ChatGPT, or for your team, push --db below serves it from Bridge.

Auth

npx @kaiva/bridge login

The terminal shows a code and opens the console. Enter the code there and approve it (owner or admin of the workspace). The key is saved for this machine in ~/.config/kaiva-bridge/credentials.json, readable only by you. whoami shows the workspace and key in use; logout revokes the key and removes it.

For CI and scripts, use a Management key from the console (Keys & access, key type Management) instead. When set, it is used in place of a saved login:

export KAIVA_BRIDGE_TOKEN=kv_mgmt_...

logout revokes only a saved login. A key you supply in KAIVA_BRIDGE_TOKEN is yours to manage: unset it, and revoke it in the console when it is no longer needed. Signing in again revokes the login it replaces.

Management keys are refused by the MCP gateway, and gateway keys are refused by the Management API: the two credential types are never interchangeable.

Quickstart: source to live server

# An API spec (only operations that read are exposed with --read-only)

npx @kaiva/bridge push my-api --openapi https://api.example.com/openapi.json --read-only

A database: DATABASE_URL from the environment or .env; Postgres, MySQL, MariaDB or SQL Server

npx @kaiva/bridge push shop-db --db --read-only

→ LIVE https://api.kaiv.ai/api/bridge/mcp/shop-db-a1b2c3d4

→ check first call: get_orders answered in 84ms (and what the AI is given)

Documents: PDF, Word, PNG, JPEG, text or Markdown files, or a folder of them

npx @kaiva/bridge push handbook --docs ./policies

waits until each file is read, then → LIVE https://api.kaiv.ai/api/bridge/mcp/handbook-a1b2c3d4

npx @kaiva/bridge install my-api --client claude-code # or --client cursor

install adds the server to Claude Code (this folder's .mcp.json, or --global) or Cursor (~/.cursor/mcp.json, or --project), keeping every other entry. The client signs in with your Kaiva account the first time; --key writes a key for this one server instead. --dry-run shows the change; uninstall removes it. For any other MCP client, key --label --replace makes a gateway key to paste with the endpoint. Run the same commands again and nothing is duplicated: push reuses the server with that name, install leaves an existing entry as it is, and key --replace swaps the key with that label.

Let your coding agent do it

npx @kaiva/bridge skill install        # adds the setup skill to Claude Code (~/.claude/skills)

Then ask: "connect my database to Claude Code with Kaiva Bridge". The skill runs the commands below, asks you before connecting without certificate checks or exposing operations that write, and confirms with a first tool call.

Examples

Runnable scripts in examples/:

• database-to-claude-code.sh: a Postgres, MySQL or MariaDB database into Claude Code
• openapi-to-cursor.sh: an OpenAPI spec into Cursor for this project
• call-from-your-app.mjs: call your MCP server from your own Node app, no dependencies

Commands

--json on push, key, install, whoami and doctor prints one JSON result on stdout (progress goes to stderr), for scripts and agents. KAIVA_BRIDGE_URL overrides the API base (defaults to https://api.kaiv.ai/api/bridge/v1).

Try before you sign up

Call a live example server from your browser, no account needed: https://app.kaiv.ai/try

---

MIT © SLATEAI LIMITED · kaiv.ai/bridge