Basin

Connect Basin to Antigravity

Basin is a connector that lets your AI assistants and other people's assistants work from one shared library, across different tools and different companies. Setting it up in Antigravity takes a few minutes.

Plan requirements and settings paths last checked 8 September 2026

01

Sign in happens as you connect

You do not need an account first. Connecting creates one: you enter your email, Basin sends a code, and you are in. The code expires in 10 minutes.

02

Add Basin to the configuration

Open Antigravity's MCP configuration and add Basin. Globally that file is ~/.gemini/config/mcp_config.json; for one workspace it is .agents/mcp_config.json.

Full steps: Antigravity's MCP documentation →

{
  "mcpServers": {
    "basin": { "serverUrl": "https://mcp.getbasin.co/mcp" }
  }
}

The key is serverUrl. Antigravity does not support the older url or httpUrl fields, and a server declared with one of those will not load.

03

Authenticate in Agent Settings

Reload the agent so it reads the new server. Open Agent Settings — Cmd+, on a Mac, Ctrl+, elsewhere — go to the Customizations tab, and select Authenticate beside Basin. Finish the sign-in in the browser and paste the code back into the settings panel.

04

Set the standing instruction

Add one line to your agent instructions, so a new session checks Basin rather than starting from nothing.

Check Basin at the start of every conversation.

Without it the assistant may not think to look. It answers from whatever is already in front of it, which is confident and sometimes wrong, and reads like Basin not working. Basin is a live connector, not a file in the workspace. If the assistant says something is not in Basin, tell it to check before believing that.

05

Check the connection

Check Basin and tell me which spaces I can access.

A successful response from Basin confirms the connection. If your library is empty, that’s fine—your next step is to save a project.

If it did not work

Basin is not in the MCP list.Reload the agent — the file is read at start-up. Then check the key is serverUrl and that the entry sits under mcpServers.
It is listed but every call fails.The sign-in has not completed. Open Agent Settings, Customizations, and select Authenticate beside Basin.
If Basin isn’t showing upCheck that sign-in completed and Basin is enabled for this conversation. Try a new conversation or reload the tool, then ask it to check Basin again. Follow your tool’s guide if its settings differ.
Connected, but the project is missing?Ask your assistant to read Basin directly. Check that the earlier conversation saved a file, that both tools use the same Basin account and that this account has access to the space.
Can read, but can’t save?Check that you have editing access to the space. A read-only invitation lets your assistant read the shared work.

Get setup help · hello@getbasin.co

Put it to work.

Save a real project brief, then open a new conversation and ask your assistant to retrieve it.

Try your first projectChoose another assistant