Ownhand

Agents, writing like you.

Ownhand is a remote MCP server that writes text in your own voice, fitted to where it is going: a Slack DM, a cold email, a PR description. It learns your voice from 5 to 10 things you wrote, then keeps learning from what you actually send.

• Endpoint: https://ownhand.dev/mcp (streamable HTTP)
• Sign-in: OAuth 2.1 with dynamic client registration. Add the URL, sign in in the browser, pick your Hand, click Allow. No API key to copy.
• New accounts start with $1 of free credit.

Set up with one sentence

Paste this into any agent (Claude Code, Codex, Cursor, Gemini CLI, and others). It adds the server, starts sign-in and sets up your Hand.

Fetch and execute the instructions to set me up for Ownhand from https://ownhand.dev/agent-setup/prompt.md. If your web tool can't open it, download it with curl or Invoke-WebRequest.

Install by client

Client	Install	Then
Claude Code	claude mcp add --transport http --scope user ownhand https://ownhand.dev/mcp	Run /mcp, pick ownhand, sign in.
Claude Code plugin	/plugin marketplace add jordan-gibbs/ownhand then /plugin install ownhand@ownhand	Adds the server and an ownhand skill. Run /mcp to sign in.
Claude (claude.ai, Desktop, mobile)	Settings, Connectors, Add custom connector, paste https://ownhand.dev/mcp	Click Connect and sign in.
ChatGPT	Settings, turn on Developer mode, add a connector with https://ownhand.dev/mcp	Sign in when asked.
Cursor	Add to Cursor above, or examples/cursor.mcp.json in ~/.cursor/mcp.json	Click Connect next to ownhand.
VS Code (Copilot)	Add to VS Code above, or code --add-mcp '{"name":"ownhand","type":"http","url":"https://ownhand.dev/mcp"}'	Sign in when asked.
Codex CLI	codex mcp add ownhand --url https://ownhand.dev/mcp	codex mcp login ownhand if no browser opened. Restart Codex if it was running (codex resume --last).
Gemini CLI	gemini mcp add --transport http --scope user ownhand https://ownhand.dev/mcp, or gemini extensions install https://github.com/jordan-gibbs/ownhand	/mcp auth ownhand
Windsurf	examples/windsurf.mcp_config.json in mcp_config.json (uses serverUrl)	Sign in when asked.
Zed	examples/zed.settings.json in your Zed settings	Sign in when asked.
Goose	goose configure, add a remote extension (streamable HTTP) with the URL	Sign in when asked.
Cline	examples/cline_mcp_settings.json (uses "type": "streamableHttp")	Click to sign in.
Anything else	A remote streamable HTTP server named ownhand at https://ownhand.dev/mcp	Sign in when asked.

Raw install deeplinks, if you want to open them yourself:

cursor://anysphere.cursor-deeplink/mcp/install?name=ownhand&config=eyJ1cmwiOiJodHRwczovL293bmhhbmQuZGV2L21jcCJ9
vscode:mcp/install?%7B%22name%22%3A%22ownhand%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fownhand.dev%2Fmcp%22%7D
vscode-insiders:mcp/install?%7B%22name%22%3A%22ownhand%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fownhand.dev%2Fmcp%22%7D
goose://extension?url=https%3A%2F%2Fownhand.dev%2Fmcp&type=streamable_http&id=ownhand&name=Ownhand&description=Write+in+your+own+voice

More configs, including VS Code (.vscode/mcp.json) and Codex (config.toml), are in examples/. The live version of this table is at https://ownhand.dev/connect.

API key instead

For clients without sign-in, scripts and CI. Create a key in the dashboard and send it as a header. X-Ownhand-Hand is optional and sets the default Hand.

claude mcp add --scope user --transport http ownhand https://ownhand.dev/mcp \
  --header "Authorization: Bearer $OWNHAND_API_KEY" --header "X-Ownhand-Hand: prof_..."

See examples/api-key.mcp.json. Treat a key like a password.

First run

Once connected, say: "Set up my Ownhand Hand." The agent asks for 5 to 10 things you wrote yourself (Slack messages, emails, PR descriptions) and how you'd describe your writing, then calls create_hand. Clients that show MCP prompts also list set_up_my_hand.

To make your agent use Ownhand without being asked, paste AGENTS.md into your CLAUDE.md, AGENTS.md, .cursorrules or custom instructions.

Tools

Tool	What it does
write	Rewrites a draft so it reads like you wrote it, fitted to the occasion. Keeps every fact. Returns the text and a request_id.
send_feedback	Reports what you did with a draft (approved, edited with the exact sent text, or rejected) so your Hand learns.
get_hand	Lists your Hands, or shows what one has learned: style card, rules, sample counts.
create_hand	Creates a Hand from texts you wrote yourself.
update_hand	Adds samples, sets how you describe your writing, or pins, rejects or activates a learned rule.
get_account	Shows your account, credit balance, recent charges and usage.

Prompts: set_up_my_hand, teach_my_voice, reply_to_thread, draft_email. Resources: ownhand://guide (the agent playbook), ownhand://occasions (the occasion table).

Occasions: chat_dm, chat_channel, email_internal, email_formal, email_cold, email_warm, proposal_cold, proposal_warm, pr_description, review_comment, docs, status_update.

How learning works

1. Your agent calls write and shows you the draft. Nothing is sent without your OK.
2. You send it as is, edit it, or drop it.
3. Your agent calls send_feedback with exactly the text you sent.
4. Ownhand compares the draft with what you sent and updates your Hand. A reason you state becomes a rule right away. A pattern it only observes has to show up twice. Learning runs in the background, and the Hand's version goes up when it finishes.

You can pin or reject any learned rule with update_hand. Learning from your feedback changes only your own Hand.

Pricing

$1 free to start. Then you add credit and pay for the tokens you use, about half a cent per rewrite. No subscription and no monthly fee. Details: https://ownhand.dev/pricing.

Privacy

• Stored: your account details, your Hands (samples, style card, learned rules), your requests and the feedback you send.
• Not stored: thread messages your agent passes as context. They are used for that one request.
• Not sold, not shared for advertising, and not used to train our own models.
• Feedback and samples go to the learning model, whose provider may use them to improve its models. If you don't want that, don't send feedback or add samples.
• You can delete a Hand or revoke a key at any time.

Read the full policy: https://ownhand.dev/privacy.

Docs

• Docs: https://ownhand.dev/docs
• Agent guide: https://ownhand.dev/docs/agent-guide.md
• Connect: https://ownhand.dev/connect
• For agents: https://ownhand.dev/llms.txt

What's in this repo

• server.json: the entry for the official MCP Registry
• .claude-plugin/, .mcp.json, skills/ownhand/: a Claude Code plugin and marketplace
• gemini-extension.json, GEMINI.md: a Gemini CLI extension
• AGENTS.md: the instruction block for any agent
• examples/: client configs

License

The configs and docs in this repo are MIT licensed (see LICENSE). The Ownhand service itself is proprietary and run by Thalient Labs.

Contact: hi@thalientlabs.ai