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

# Connect via MCP JSON

> Generic mcpServers JSON for Cursor, Claude Desktop and other MCP clients.

The Hub speaks standard MCP over Streamable HTTP with a Bearer header. Any client that supports a remote `url` plus `headers` works.

## Generic config

```json theme={null}
{
  "mcpServers": {
    "social-monitor": {
      "url": "https://monitor.solobiz.academy/api/mcp",
      "headers": { "Authorization": "Bearer ${SOCIAL_MONITOR_KEY}" }
    }
  }
}
```

Use the env var form when the client expands `${VAR}`. If it does not, put the literal `Bearer smk_...` value and keep the file out of git.

## By client

| Client | Config file | Note |
| - | - | - |
| Cursor | `~/.cursor/mcp.json` or `.cursor/mcp.json` | Generic block above |
| Claude Desktop | `claude_desktop_config.json` | Remote servers are usually added in Settings, Connectors. If only stdio is supported, use `mcp-remote` below |
| Hermes Agent, GrokBot | see [Hermes and GrokBot](https://monitor-docs.solobiz.academy/agents/connect-hermes-grokbot.md) | |
| Claude Code, Codex | see their pages | CLI commands are easier |

## stdio-only clients via mcp-remote

```json theme={null}
{
  "mcpServers": {
    "social-monitor": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://monitor.solobiz.academy/api/mcp",
        "--header", "Authorization:${AUTH_HEADER}"
      ],
      "env": { "AUTH_HEADER": "Bearer smk_xxxxxxxx_xxxxxxxx" }
    }
  }
}
```

No space after the colon in `--header`: some clients mangle spaces in args, hence the `env` value.

## Verify

Ask the agent to call `list_channels`. No tools visible: check the client's MCP log, then the key (401 means wrong or revoked). Still stuck: use [HTTP bots](https://monitor-docs.solobiz.academy/agents/connect-http-bots.md).


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