Protocols

Claude connector (MCP with your account)

Connect your Ghosty account to Claude, Claude Code or any MCP client with OAuth; from there you talk to your agents, review conversations and work your sales board.

Updated 2026-10-13

Open in Claude ↗Open in ChatGPT ↗?

Ask your coding agent

Connect Ghosty as an MCP connector (https://www.ghosty.studio/mcp) and ask my main agent for a summary of today's leads.

Paste it in Claude Code, Cursor or Codex with the ghosty-agent skill installed.

https://www.ghosty.studio/mcp is the MCP server for your account. Unlike the , it signs in with your login (OAuth 2.0) and works on what is yours: your agents, your conversations and your agents' sales board.

Connect

The client opens the Ghosty screen: sign in with Google, Apple or email, review the permissions and tap Allow. No keys to copy.

Tools

Tool	What it does	Kind
`whoami`	Your account, plan and granted permissions	read
`list_agents`	Your agents (id, engine, model, channels)	read
`list_conversations`	Your conversations with an agent, or search with `query`	read
`read_conversation`	The latest messages of a conversation	read
`message_agent`	Messages an agent and waits for its reply (~3 min)	write
`get_agent_reply`	The reply of an agent that was still working	read
`crm_search_leads`	Leads on the agent's sales board	read
`crm_read_lead`	A lead's conversation	read
`crm_reply_lead`	Asks the agent to answer what a WhatsApp Business lead left pending	write
`crm_pause_lead`	Pauses or resumes the agent on a lead	write
`list_files`	Your file library, with temporary links	read
`get_usage`	Your personal plan usage	read

Every tool calls the same the app and the CLI use, with your token: it sees and does exactly what you can on the web. An agent shared with you shows up if you have access; a team space's board, if you are a member.

Permissions

Scope	What for
`profile`	Know who you are (your email)
`agents:read`	See your agents and talk to them
`agents:write`	Send them work and operate the board
`files`	Read your file library

Revoke

Remove the connector in Claude, or sign that app out from your Ghosty account: the token stops working on the server right away.

For client builders

Discovery: /.well-known/oauth-protected-resource/mcp (RFC 9728) and /.well-known/oauth-authorization-server (RFC 8414).
Dynamic registration: POST /oauth2/register (RFC 7591). Public client with mandatory PKCE S256.
Streamable HTTP over POST, no SSE or session; GET /mcp returns 405.
Without a token, /mcp returns 401 with WWW-Authenticate: Bearer resource_metadata="…".

← Previous

Documentation MCP

CLI — Ghosty from your terminal