> ## Documentation Index
> Fetch the complete documentation index at: https://docs.neus.network/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Proofable

> Install Proofable in any editor, chat, or agent host. Click Connect and sign in.

Proofable MCP is the hosted connection for every MCP client: chat, IDEs, jobs, and agent runtimes. Same profile, proofs, listings, permissions, and private context. Not a developer-only add-on.

## Install (one minute)

1. Open [proofable.me/install](https://proofable.me/install), or add `https://mcp.neus.network/mcp` in your editor, chat, or agent.
2. Click **Connect**. Sign in in the browser.
3. Ask for your profile and current proofs.

Proofable answers **Passed**, **Action needed**, or **Blocked**.

If the host already offers a Proofable plugin, install that.

Have the CLI?

```bash theme={"dark"}
neus setup
```

## Any host

Paste this URL in the host’s MCP settings:

`https://mcp.neus.network/mcp`

```json theme={"dark"}
{
  "mcpServers": {
    "neus": {
      "url": "https://mcp.neus.network/mcp"
    }
  }
}
```

If the host requires the spec `type` field:

```json theme={"dark"}
{
  "mcpServers": {
    "neus": {
      "type": "http",
      "url": "https://mcp.neus.network/mcp"
    }
  }
}
```

## Paste this prompt

```text theme={"dark"}
# Proofable connect

Connect this host to Proofable. MCP is how I use Proofable from any chat, IDE, or job runtime: profile, proofs, listings, permissions, and private context.

1. Install Proofable on this host (plugin, install page, or https://mcp.neus.network/mcp). Do not add a second neus entry.
2. Tell me to click Connect if sign-in is not done.
3. Call neus_context once. Reuse existing proofs before a new check. Before spend, publish, secrets, or a sensitive tool, check proofs first. Summarize as Proofable: Passed, Action needed, or Blocked.
4. If I want to sell: open payouts at https://proofable.me/profile?tab=treasury, then create a listing at https://proofable.me/profile/portals/new. Walk me through type, what to verify, price, and Listed. Do not invent proof IDs or verifier IDs.
5. If I need an agent, create or import it on my signed-in profile. Use generate only for a dedicated spend key.

Canonical endpoint: https://mcp.neus.network/mcp
Docs: https://docs.neus.network/mcp/setup
```

## After Connect

### Check the connection

Ask:

> Reuse what I already have. Before a sensitive action, check my current proofs.

Read a known proof with **`neus_proofs_get`**.

Create or import an agent when you need one:

```text theme={"dark"}
Create or import an agent on my NEUS profile. Use generate if I need a
separate spend account. Set spend and action limits. Then confirm it is
ready.
```

That uses **`neus_agent_create`**. Default is your signed-in account. Use **`generate`** only for a dedicated spend key. Confirm with **`neus_agent_link`**.

Open **Connections** on [proofable.me](https://proofable.me) to link apps. [Connections](../cookbook/connector-integrations)

Cursor, Claude Code, Codex, Hermes, and Grok use the same endpoint. Optional project mount:

```bash theme={"dark"}
npx -y -p @neus/sdk neus mount <agentId> --apply cursor
```

Valid `--apply` values: `cursor`, `claude`, `codex`. See [Connect agent context](../agents/runtime-mount).

### List and sell

1. **Payouts** (paid listings): [Treasury](https://proofable.me/profile?tab=treasury) → Set up payouts.
2. **New listing:** [Create listing](https://proofable.me/profile/portals/new).
3. Pick the type (AI service, skill, digital product, and the other live types).
4. Add what buyers must verify. Set a price or keep it free. Discovery: **Listed**.
5. Share the listing link.

Job placeholders become buyer inputs. Buyers connect apps at checkout.

Embed a gate in your own app: [Sell access](../quickstart).

## From a terminal

Optional if you have the CLI. Writes the same hosted URL and the public workflow skill:

```bash theme={"dark"}
neus setup
```

If you use npm and do not have the CLI on your PATH:

```bash theme={"dark"}
npx -y -p @neus/sdk neus setup
```

If a Proofable plugin is already installed, setup skips a second `neus` entry.

## Advanced: access keys

Use Connect for interactive clients. Use a [profile access key](https://proofable.me/profile?tab=account) only when browser sign-in is unavailable, such as a server or CI job.

```bash theme={"dark"}
export NEUS_ACCESS_KEY=npk_...
neus setup
```

Treat the key like a password. Never paste it into chat or commit it to a repository.

## Disconnect

```bash theme={"dark"}
neus disconnect --access-key <token>
```

## Troubleshooting

* **No tools appear:** restart the MCP client after the endpoint is registered.
* **No Connect, or Unauthorized with Logout visible:** click **Logout**, then **Connect**.
* **Host has no Connect:** use the host’s own MCP login after the endpoint is registered.
* **Two neus servers:** a marketplace plugin and a user MCP config both registered NEUS. Remove the extra `neus` key from the host MCP config. If you used the CLI, run `neus setup` again to drop the leftover user entry.
* **Confirm the connection:** `neus doctor --live` (Node).
* **Agent permission missing:** create or refresh the agent permission on Proofable, then run `neus mount` again.
* **Search-only endpoint:** use `https://mcp.neus.network/mcp`. `https://docs.neus.network/mcp` only searches documentation.

[MCP overview](./overview) lists the twelve tools. For a laptop, server, or confidential VM, see [Private Cloud Trust Harness](../cookbook/private-cloud-agents).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.