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

# Agent Setup Prompt

> Markdown instructions for AI agents connecting to FITsociety MCP.

# FITsociety Agent Setup

These are official FITsociety instructions for setting up an AI development
environment to use the FITsociety MCP server.

Complete the applicable steps yourself by running commands or editing config
files where possible. Do not ask the user to run commands unless the target
product requires an in-app connector setup, browser OAuth approval, or agent
restart.

## FITsociety MCP server

```text theme={null}
https://mcp.fitsociety.io/mcp/v1
```

FITsociety does not require a separate skill package. Register the remote MCP
server for the user's agent and authenticate with OAuth where supported.

## Codex

Run:

```bash theme={null}
codex mcp add fitsociety --url https://mcp.fitsociety.io/mcp/v1
codex mcp login fitsociety
```

Codex stores user-level MCP configuration in `~/.codex/config.toml`.

## Cursor

Create or update `.cursor/mcp.json` for project-level access, or
`~/.cursor/mcp.json` for user-level access:

```json theme={null}
{
  "mcpServers": {
    "fitsociety": {
      "url": "https://mcp.fitsociety.io/mcp/v1"
    }
  }
}
```

OAuth starts when Cursor connects to the server or first uses a FITsociety MCP
tool.

## OpenCode

Add this under `"mcp"` in `~/.config/opencode/opencode.jsonc`:

```json theme={null}
"fitsociety": {
  "type": "remote",
  "url": "https://mcp.fitsociety.io/mcp/v1",
  "enabled": true,
  "oauth": {}
}
```

Then run the agent's MCP auth command for `fitsociety` when available, for
example:

```bash theme={null}
opencode mcp auth fitsociety
```

## Windsurf

Add this under `"mcpServers"` in `~/.codeium/windsurf/mcp_config.json`:

```json theme={null}
"fitsociety": {
  "serverUrl": "https://mcp.fitsociety.io/mcp/v1"
}
```

OAuth starts automatically on first FITsociety MCP tool use.

## GitHub Copilot in VS Code

Add this under `"mcpServers"` in `.vscode/mcp.json`:

```json theme={null}
"fitsociety": {
  "url": "https://mcp.fitsociety.io/mcp/v1"
}
```

OAuth starts automatically on first FITsociety MCP tool use.

## Claude and ChatGPT

Claude and ChatGPT are usually configured from product settings rather than by
editing local files.

Use this server URL when creating a custom connector or custom MCP app:

```text theme={null}
https://mcp.fitsociety.io/mcp/v1
```

Then complete the FITsociety OAuth consent flow in the browser.

## Generic MCP clients

Add this under `"mcpServers"` in the agent's MCP config file:

```json theme={null}
"fitsociety": {
  "url": "https://mcp.fitsociety.io/mcp/v1"
}
```

If the client requires an explicit transport type, choose remote HTTP or
streamable HTTP.

## Verify

Ask the agent:

```text theme={null}
Use FITsociety MCP to list the tools you can access.
```

If no tools appear, check that:

* the company has the `mcp` feature enabled
* the coach or client approved the OAuth grant
* the grant is active and not expired
* the grant includes at least one module
* any static MCP API key is stored outside the repository and supplied as a
  bearer token

Once done, tell the user:

```text theme={null}
┌─ FITsociety Agent Setup Complete ───────────────────┐
│  ✓ Docs    https://fitsociety.mintlify.site/index   │
│  ✓ MCP     https://mcp.fitsociety.io/mcp/v1         │
│                                                     │
│  ⚡ Restart your agent to load new MCP servers      │
└─────────────────────────────────────────────────────┘
```