> ## 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 HTTP bots

> MausBot and custom bots without an MCP client: plain HTTP with curl.

Use this when your bot has no MCP client. Same key, roles and error codes as MCP.

## Setup

```bash theme={null}
export API=https://monitor.solobiz.academy/api/open/v1
export SOCIAL_MONITOR_KEY=smk_xxxxxxxx_xxxxxxxx   # from the secret store, not hard-coded
```

Every request sends `Authorization: Bearer $SOCIAL_MONITOR_KEY`.

## First calls

```bash theme={null}
curl -sS "$API/channels" -H "Authorization: Bearer $SOCIAL_MONITOR_KEY"
curl -sS "$API/inbox/status" -H "Authorization: Bearer $SOCIAL_MONITOR_KEY"
curl -sS "$API/inbox/comments" -H "Authorization: Bearer $SOCIAL_MONITOR_KEY"   # empty page + next_cursor
```

## Poll loop (summary)

```
cursor = saved cursor, or next_cursor of the first empty page
every 60 s:
  page = GET /inbox/comments?cursor=<cursor>&limit=50
  handle every item (skip handled=true)
  save page.next_cursor only after the whole page is handled
```

Full loop, idempotency keys and error table: [Comment inbox loop](https://monitor-docs.solobiz.academy/agents/comment-inbox-loop.md). Publishing: [Publishing workflow](https://monitor-docs.solobiz.academy/agents/publishing-workflow.md).

## MCP tool to HTTP route

| MCP tool | HTTP |
| - | - |
| `list_channels` | `GET /channels` |
| `list_groups` | `GET /groups` |
| `create_post` | `POST /posts` |
| `list_posts` | `GET /posts` |
| `get_post` | `GET /posts/:id` |
| `get_post_status` | `GET /posts/:id/status` |
| `cancel_post` | `DELETE /posts/:id` |
| `get_inbox_status` | `GET /inbox/status` |
| `poll_new_comments` | `GET /inbox/comments?cursor=` |
| `list_unhandled_comments` | `GET /inbox/comments?since_hours=&include_handled=false` |
| `get_comment` | `GET /inbox/comments/:id` |
| `reply_to_comment` | `POST /inbox/comments/:id/reply` |
| `private_reply` | `POST /inbox/comments/:id/private-reply` |
| `mark_comment_handled` | `POST /inbox/comments/:id/handled` |
| `hide_comment` | `POST /inbox/comments/:id/hide` |

HTTP also has `DELETE /posts/:id/targets/:channelId/published` (delete a published post on the platform), which MCP deliberately does not expose.


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