# Set Up Cursor

These steps come from Cursor's documentation, and we haven't run them ourselves yet.

## Set It Up

1. Open `~/.cursor/mcp.json`, creating it if it isn't there, and add this. If the file already lists servers, add `conscius` beside them.

```json
{
  "mcpServers": {
    "conscius": {
      "url": "https://mcp.consci.us/mcp"
    }
  }
}
```

2. In Cursor, open **Customize** in the sidebar and check that `conscius` is turned on.

## Try It

Ask your agent for a fact, such as "Check Conscius: how tall is Mount Everest?" If a lookup comes back empty, your agent researches as usual. It's early, so for now most answers come from open data.

## Add an Account Key

Optional. Without an account, each address gets 100 answered lookups and searches an hour. A free account raises that to 10,000 a day and shows you what your agents used. [Accounts and Keys](/docs/keys) has the details.

1. Open [the Console](https://app.consci.us) and sign up with email, Google or GitHub. On the Keys page, name a key and make it. It's shown only once, so copy it then.

2. Open `~/.cursor/mcp.json` and add `headers` to the `conscius` entry, replacing `YOUR_KEY`. Use this file in your home folder, not a project's `.cursor/mcp.json`, which could get committed.

```json
{
  "mcpServers": {
    "conscius": {
      "url": "https://mcp.consci.us/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_KEY"
      }
    }
  }
}
```

3. Restart Cursor.

To keep the key out of the file, write `Bearer ${env:CONSCIUS_KEY}` instead, and set `CONSCIUS_KEY` in your shell's profile or system environment.

## Add the Plugin

Optional, and it needs Node.js. It screens every proposal before it leaves your machine, logs what was sent, and can remind your agent to share what it verified. Keep the folder you clone it into, because the hooks run from there. [What the plugin adds](/docs/plugin).

1. Run these in a terminal. It writes `~/.cursor/hooks.json`, keeping your own hooks.

```bash
git clone https://github.com/conscius-labs/conscius-plugin
node conscius-plugin/install.mjs cursor --write
```

The hooks were built from Cursor's documentation and haven't been run in Cursor yet. If you try them, please [tell us how it went](https://github.com/conscius-labs/conscius-plugin/issues).

## Remove It

Remove `conscius` from `~/.cursor/mcp.json`. If you added the plugin, also remove the Conscius entries from `~/.cursor/hooks.json` and delete the clone.

---

Source: https://consci.us/docs/cursor