MCP server
Connect Claude Code, the Claude apps, and other MCP clients to Hyperagent.
Hyperagent runs a hosted Model Context Protocol (MCP) server at https://hyperagent.com/api/mcp, so any MCP client can drive your agents: list the agents you can reach, start threads that run in the background, send follow-ups, and read results. This page covers the tools a client gets, how to connect, and how access works.
Tools
Once connected, a client has these tools:
| Tool | What it does |
|---|---|
list_agents | List the agents you can start threads on, with each agent's id, name, and description. |
create_thread | Start a new thread running one of your agents. Returns a threadId right away; the agent works in the background. |
send_message | Add a follow-up turn to an existing thread — runs immediately if the thread is idle, or after the current turn finishes. |
get_thread | Read a thread's messages and whether it's still running. Poll this to track progress and collect results. |
list_threads | Browse your threads. |
create_attachment_upload | Attach a file to a thread without pulling its bytes into your context — returns an upload URL you PUT the file to, plus a fileId to pass along. |
Connect a client
Every client points at https://hyperagent.com/api/mcp and authenticates with a one-time browser sign-in (Google, Apple, or Microsoft) plus a consent step. After that the client holds a token and reconnects on its own.
Claude Code
claude mcp add --transport http hyperagent https://hyperagent.com/api/mcpLaunch Claude Code, run /mcp, select hyperagent, and complete the browser sign-in.
Claude (web and desktop)
Open Settings → Connectors → Add custom connector, give it a name, and enter https://hyperagent.com/api/mcp. Connect and approve the consent screen.
Other MCP clients
Any client that supports a remote, OAuth-authenticated HTTP MCP server can connect to https://hyperagent.com/api/mcp. For client-specific steps and to manage authorized connections, see hyperagent.com/settings/mcp-access.
Access
When you connect a client, you sign in and approve a consent screen. The client then acts as you and can:
- Read your agents, threads, and messages.
- Create threads and send messages on your behalf.
A connected client gets no access you don't already have — it can only reach the agents you can. Review and revoke connected clients anytime at hyperagent.com/settings/mcp-access.
A typical run
| Step | Call |
|---|---|
| Find an agent | list_agents, then copy its id |
| Start a thread | create_thread with that agentId and a self-contained message; returns a threadId |
| Wait for it | poll get_thread until the thread is no longer running |
| Read or continue | read the final messages, or send_message to keep going |
The opening message becomes the thread's first user turn, so make it self-contained — the agent runs in the background with no one to clarify mid-run. To attach a file, call create_attachment_upload, PUT the bytes to the returned URL, then pass the fileId to create_thread or send_message.