Basin

Connect Basin to Cursor

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 Cursor takes a few minutes.

Plan requirements and settings paths last checked 29 August 2026

01

Sign in happens as you connect

You do not need an account first. The first time Cursor reaches Basin it opens a browser to sign you in: you enter your email, Basin sends a code, and you are in. The code expires in 10 minutes.

02

Add the server to your config

Cursor connects through a config file, not a settings screen. Add Basin to .cursor/mcp.json in a project, or ~/.cursor/mcp.json for every project:

Full steps: Cursor MCP →

Add to CursorOpens Cursor and pre-fills the server. Needs Cursor installed on this machine.
{
  "mcpServers": {
    "basin": { "url": "https://mcp.getbasin.co/mcp" }
  }
}

The url key is what marks it a remote server. Cursor handles the sign-in through a browser.

When you connect, Basin asks for two things: read access to the spaces you own and the ones shared with you, and write access to files in those spaces, stamped with your email. Connecting shares nothing with anyone else. Sharing is always a separate step.

03

Reload after you add it

Reload Cursor after editing the config so it picks up the server. A window that was already open will not see Basin.

04

Set the standing instruction

Add one line as a Cursor rule, in .cursor/rules:

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 folder in the project. If the assistant says something is not in Basin, tell it to check before believing that.

05

Verify

Ask for something that needs a real read:

What is in my Basin library?

If it names your spaces, it is working.

If it did not work

No Basin tools at all.The server is not running. Check the entry in mcp.json is valid JSON and reload Cursor. A green dot next to Basin in the MCP settings means it connected.
Fewer than 17 tools.Cursor is holding an old tool list. Toggle Basin off and on in the MCP settings, or reload. Basin serves 17 tools; fewer means the list is stale.
The tools are there but the assistant never uses them.The standing rule above is missing. Add it. This one does not look like a connection problem, which is why it is the common one.