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

# Perps client setup

> Connect perps execution tools using the right host configuration.

This is **write access (Degen mode)**. It requests `tools:execute` and can perform perps actions. For research only, use [Gina Read](https://docs.askgina.ai/mcp-access/gina-read.md).

To install the Perps connection as a plugin instead, use `ask-gina-perps`. See [install for your host](https://docs.askgina.ai/agents/plugins-and-skills.md#install-for-your-host).

## Claude Code

```sh theme={null}
claude mcp add --transport http perps https://askgina.ai/ai/perps/mcp
```

Open `/mcp` in Claude Code and complete OAuth. See [Claude setup](https://docs.askgina.ai/connect/claude.md) for the host's authentication flow.

## Codex

```sh theme={null}
codex mcp add perps --url https://askgina.ai/ai/perps/mcp
codex mcp login perps
```

Alternatively, merge this into your Codex configuration, then run the login command:

```toml theme={null}
[mcp_servers.perps]
url = "https://askgina.ai/ai/perps/mcp"
```

## Cursor

Merge the entry into `.cursor/mcp.json` or `~/.cursor/mcp.json`, preserving other servers:

```json theme={null}
{
  "mcpServers": {
    "perps": {
      "url": "https://askgina.ai/ai/perps/mcp"
    }
  }
}
```

Connect and complete Gina OAuth from Cursor's MCP settings.

## Other clients and manual tokens

Use a [Streamable HTTP client](https://docs.askgina.ai/connect/other-clients.md) with this venue URL. Check the host's support for execution tools before connecting. For Bearer-token clients, follow [authentication](https://docs.askgina.ai/agents/authentication.md) and deliberately choose **Full access — view and execute**; keep only the required venue entry.

The credential must be valid for this venue and carry `tools:execute`. A read-only token or an old Gina execute grant is not a substitute. Complete a fresh connection if the grant is rejected.

Next: run the [read-only connection checks](https://docs.askgina.ai/perps-mcp/quick-start.md) before attempting execution.

## Check that it works

Restart the client and complete Gina OAuth. In Claude Code, `/mcp` should list `perps` as connected, and `bash` should appear in the tool list. Call `bash` with:

```json theme={null}
{ "command": "capabilities --json" }
```

Expected: one payload with `commands` and `hostTools`. The call only reads data. If `bash` is missing, remove the server, add it again and reconnect.


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