yugabytedb logo Claude Code

How to use YugabyteDB with Claude Code

You want YugabyteDB inside Claude Code so it can map the database before writing queries, investigate a data issue, check data quality across related tables, and answer an operational database question — without you copy-pasting between tabs. Here is the whole setup, once.

Create your YugabyteDB gateway

The gateway is the thing Claude Code connects to, and it is where you decide which YugabyteDB tools an agent may use. You create it once and every client reuses it.

  1. Create an Arcade account

    Sign up and open the dashboard. The free tier is enough to follow this through.

  2. Create an MCP Gateway and select your YugabyteDB tools

    In the dashboard, create a gateway and pick the YugabyteDB tools you want to expose. The gateway is what your client connects to, and it is where tool access is decided.

  3. Copy your gateway URL

    Every client below needs it.

    https://api.arcade.dev/mcp/<YOUR-GATEWAY-SLUG>

Create a YugabyteDB gateway Opens the gateway builder in your Arcade dashboard.

Connect the gateway to Claude Code

  1. Add the gateway as a remote HTTP MCP server

    claude mcp add arcade --transport http "<YOUR_ARCADE_GATEWAY_URL>"

  2. Verify it was added

    claude mcp get arcade
    claude mcp list

  3. Try it out

    Open Claude Code in your project and ask it to use one of your YugabyteDB tools.

Full Claude Code guide in the docs steps verified 2026-08-13

Try these YugabyteDB prompts

Claude Code can now act on your YugabyteDB account. Click a prompt to copy it.

Use a read-only database credential so an agent can inspect schemas and query data without changing records. Pair it with Contextual Access policies to limit which database access the agent can use.

Ready to actually ship your agent?

Free to start. Ready for enterprise when you are.