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

  1. Sign in and open Account.
  2. Under Agent access, create a key named for where it will run, like “Claude Code on my laptop”.
  3. 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 Code
claude mcp add --transport http genhone https://mcp.genhone.com/mcp --header "Authorization: Bearer YOUR_KEY"

In Cursor, add Genhone to your mcp.json:

Cursor
{
  "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:

Homebrew
brew install genhone/tap/genhone
install script
curl -fsSL https://raw.githubusercontent.com/genhone/cli/main/install.sh | sh

On Windows, download the windows_amd64 zip from the releases page and put genhone.exe on your PATH.

Read your ideas

CLI usage
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:

REST API
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_123

No account yet?

Refine and score your first idea, then hand it to your agent.