Agent access
Use Genhone from your coding agent
You refined and scored an idea in Genhone. Your coding agent can read the result while it
builds. Connect Claude Code, Cursor, or any MCP client with a read-only API key — nothing to
install. Prefer the terminal? Install the genhone CLI.
What your agent can read
- list_ideas
- Your ideas with status and overall score.
- get_idea
- The refined artifact with all 12 sections, from customer definition to GTM.
- get_evaluation
- The evaluation report: 18 criteria with scores, confidence, and reasoning.
API keys are read-only. They cannot create, edit, evaluate, or delete ideas.
1. Create a read-only API key
- Sign in and open Account.
- Under Agent access, create a key named for where it will run, like “Claude Code on my laptop”.
- Copy the key right away. Genhone shows the full secret once.
Keys start with gnh_. You can keep up to five active keys
and revoke any of them from the same panel.
Create a key in your account →
2. Connect your MCP client
claude mcp add --transport http genhone https://mcp.genhone.com/mcp --header "Authorization: Bearer YOUR_KEY"In Cursor, add Genhone to your mcp.json:
{
"mcpServers": {
"genhone": {
"url": "https://mcp.genhone.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_KEY"
}
}
}
}Any other MCP client
Point it at https://mcp.genhone.com/mcp over Streamable HTTP and
send your key as a bearer token — Authorization: Bearer YOUR_KEY — on every request.
Use one key per client. When a laptop or tool changes, revoke just that key.
Or work from the terminal
The genhone CLI reads the same artifacts from your shell or an
agent sandbox.
Install
On macOS and Linux, use Homebrew or the install script:
brew install genhone/tap/genhonecurl -fsSL https://raw.githubusercontent.com/genhone/cli/main/install.sh | shOn Windows, download the windows_amd64 zip from the releases page and put genhone.exe on your PATH.
Read your ideas
export GENHONE_API_KEY="YOUR_KEY"
genhone ideas list
genhone ideas show "idea_123"
genhone ideas evaluation "idea_123"Output is Markdown. Add --format json when another tool parses it.
Or call the REST API directly
The same gateway serves a read-only REST API under /v1:
curl -H "Authorization: Bearer YOUR_KEY" \
https://mcp.genhone.com/v1/ideas/
curl -H "Authorization: Bearer YOUR_KEY" \
https://mcp.genhone.com/v1/ideas/idea_123No account yet?
Refine and score your first idea, then hand it to your agent.