Hopper.so MCP Server
README.md
# Hopper.so MCP server for ChatGPT and Claude
**Yes, ChatGPT, Claude and other AI agents can work in your Hopper.so account.** Cotlet.dev connects your signed-in Cloud Browser to a hosted MCP server for community posts, group chats, courses and shared resources. Writes ask for your confirmation by default.
Source: [Hopper.so integration page](https://cotlet.dev/integrations/hopper-so-api-mcp-server?utm_source=github&utm_medium=readme&utm_campaign=hopper-so).
The page reports 4 hosted features: `publish_community_post`, `send_group_chat_message`, `create_course`, and `share_resources`.
Each supports a `list` action; writing actions ask first by default. You can change confirmation per tool.
## What you can ask
> Read the latest posts in my community feed.
> Draft a weekly community post for my approval.
> Read the latest messages in my cohort group chat.
> Create a course with the title and description I provide.
> Share my worksheet link with the community after I approve it.
## Connect ChatGPT and Claude
1. [Get access to Hopper.so](https://cotlet.dev/signup?app=hopper-so).
2. Enable Hopper.so and sign in at `https://hopper.so/c/login` in your Cotlet.dev Cloud Browser, using email, Google or Apple.
3. In ChatGPT, add `https://cotlet.dev/mcp/v1/connect` in Settings > Apps & Connectors, with OAuth.
4. In Claude, add the same URL in Settings > Connectors > Add custom connector.
## Connect Codex and Claude Code
Codex uses the hosted MCP endpoint with an API key from your Cotlet.dev console:
```toml
[mcp_servers.cotlet]
url = "https://cotlet.dev/mcp/v1"
bearer_token_env_var = "COTLET_API_KEY"
```
Claude Code:
```bash
claude mcp add --transport http cotlet https://cotlet.dev/mcp/v1 --header "Authorization: Bearer $COTLET_API_KEY"
```
## Optional local MCP wrapper
Python 3.10+, standard library only. This repository also provides seven generic browser helpers over the hosted Cotlet.dev tools: `hopper_so_guide`, `hopper_so_status`, `hopper_so_open`, `hopper_so_read`, `hopper_so_click`, `hopper_so_type`, `hopper_so_close`.
These helpers are separate from the four business features described on the integration page.
They list without a key; calling them requires `COTLET_API_KEY`.
```bash
export COTLET_API_KEY="your-key"
python3 hopper_so_agent.py serve
```
For a local-only MCP client, use an absolute path to the file:
```json
{"mcpServers":{"hopper-so":{"command":"python3","args":["/absolute/path/to/hopper_so_agent.py","serve"],"env":{"COTLET_API_KEY":"your-key"}}}}
```
Other commands: `connect`, `status`, `guide`, `read`, `tools`.
The `read` command opens the browser, reads the page and closes the browser session.
## Questions
**Does Hopper.so have a public API?**
The Cotlet.dev integration page reports no public Hopper.so API, official MCP server or official ChatGPT or Claude connector, checked 15 November 2026.
**How do I connect Hopper.so to ChatGPT?**
Sign up at https://cotlet.dev/signup?app=hopper-so, enable Hopper.so and sign in in your Cloud Browser. Add https://cotlet.dev/mcp/v1/connect to ChatGPT with OAuth.
**Can I use Hopper.so with Claude?**
Yes. Add https://cotlet.dev/mcp/v1/connect as a custom connector in Claude and sign in to Cotlet.dev.
**Is this an official Hopper.so MCP server?**
No. Cotlet.dev is independent and is not affiliated with Hopper.so. The hosted integration works in your own signed-in account.
## Account and control
Use your own Hopper.so account. The integration covers community posts, chats, courses and resources.
Hopper.so billing, shop prices, payouts, member removal and account settings stay in Hopper.so.
Disable the integration for agents, reset the browser or sign out to cut access.
Cotlet.dev is independent and is not affiliated with Hopper.so or Hopper Pte. Ltd.