Installation

The default is the one-line installer: it finds the agents on your machine, installs the AgentKey skill into each one, registers the hosted MCP server and opens a browser tab to sign in. No API key to copy, no JSON to edit.

One-line installer (recommended) — any agent the skills CLI supports
Plugin marketplace — Claude Code, Codex, Gemini CLI, Kimi CLI, OpenClaw
Prompt install — chat agents that can install a skill from ClawHub
Desktop config — Claude Desktop / Cowork
Manual MCP entry — any other client that speaks MCP

The console get-started flow picks the method for your agent and gives you the exact command for your OS. The full list is on Supported Agents.

One-line install (recommended)

curl -fsSL https://agentkey.app/install.sh | bash

irm https://agentkey.app/install.ps1 | iex

The installer probes well-known config directories and binaries to detect the agents you have — Claude Code, Codex, Gemini CLI, Cursor and every other agent the skills CLI supports — installs the skill into each, then authenticates with AgentKey in the browser. Restart your agent afterwards and ask it something that needs the internet.

These commands download a script and run it immediately. To review it first, download and read it before executing:

curl -fsSL https://agentkey.app/install.sh -o install.sh
less install.sh    # review, then:
bash install.sh

Installer flags (CI, specific agents, skill-only)

# Non-interactive (CI / unattended): every detected agent, no prompts
curl -fsSL https://agentkey.app/install.sh | bash -s -- --yes

# Show which agents would be selected on this machine, then exit
curl -fsSL https://agentkey.app/install.sh | bash -s -- --list-agents

# Only these agents (overrides detection)
curl -fsSL https://agentkey.app/install.sh | bash -s -- --only claude-code,cursor

# Let the skills CLI install for every agent it finds
curl -fsSL https://agentkey.app/install.sh | bash -s -- --all-agents

# Only the skill, or only the MCP sign-in
curl -fsSL https://agentkey.app/install.sh | bash -s -- --skip-mcp
curl -fsSL https://agentkey.app/install.sh | bash -s -- --skip-skill

# Opt out of anonymous telemetry at install time
curl -fsSL https://agentkey.app/install.sh | bash -s -- --no-telemetry

PowerShell equivalents: -Yes, -ListAgents, -Only, -AllAgents, -SkipMcp, -SkipSkill.

Manual two-step (npx)

The installer runs two commands under the hood. Run them yourself if you prefer, or if the installer cannot reach your machine:

# 1. Install the skill into every detected agent
npx skills add chainbase-labs/agentkey

# 2. Sign in and register the hosted MCP server
npx -y @agentkey/cli --auth-login

On a headless machine (SSH, Docker) the sign-in step prints the URL as well as trying to open a browser — finish it from any device. To paste a key instead, npx -y @agentkey/cli --setup opens an interactive wizard.

Plugin marketplaces

Agents with a plugin system can install AgentKey from their own marketplace. Each plugin bundles the MCP server entry; complete the sign-in your client shows afterwards.

Claude Code
Codex
Gemini CLI
Kimi CLI
OpenClaw

claude plugin marketplace add chainbase-labs/agentkey
claude plugin install agentkey@agentkey
claude mcp login plugin:agentkey:agentkey

codex plugin marketplace add chainbase-labs/agentkey
codex plugin install agentkey@agentkey
codex mcp login agentkey

gemini extensions install https://github.com/chainbase-labs/agentkey --ref=main

The extension requests OAuth on its own; if Gemini only reports that authentication is required, run /mcp auth agentkey, then /mcp reload.

/plugins install https://github.com/chainbase-labs/agentkey

openclaw skills install @chainbase/agentkey

Cursor and ChatGPT Desktop install from their in-app marketplace UI; the console get-started flow has the click path with a short video.

Prompt install (chat agents)

For chat-based agents that can install skills, paste this prompt and let the agent install the skill from ClawHub and finish setup:

Install the skill @chainbase/agentkey from ClawHub: https://clawhub.ai/chainbase/skills/agentkey
Scope the work to this skill only. After install, read the skill's metadata and
help me finish setup based only on what you can verify from that page — don't
invent missing requirements. Ask before making any broader environment changes.

The prompt deliberately scopes the agent to the AgentKey skill only and tells it to rely on the skill’s own metadata rather than guessing — so it won’t make broader changes to your environment without asking.

Claude Desktop / Cowork (desktop config)

Claude Desktop needs two pieces: the MCP server configured, then the skill file imported.

Configure the MCP server

Run the one-line installer to register the MCP server:

curl -fsSL https://agentkey.app/install.sh | bash

irm https://agentkey.app/install.ps1 | iex

Download the AgentKey skill

Download agentkey.skill. The /latest/ URL always points to the newest release — no version number to track.

Import the skill into Claude Desktop

Drag the .skill file into the Claude Desktop chat box (or double-click it while Claude Desktop is running). Claude confirms with “Skill imported”. The skill then works in both the Chat tab and Cowork.

Any other MCP client

Add the hosted server in your client’s MCP settings:

Transport: HTTP
URL: https://api.agentkey.app/v1/mcp
Auth header: none — leave it out

A client that supports MCP OAuth opens a browser to authorize on first connect. If yours only takes a static header, create a key in the console and add it:

{
  "mcpServers": {
    "agentkey": {
      "type": "http",
      "url": "https://api.agentkey.app/v1/mcp",
      "headers": { "Authorization": "Bearer ak_..." }
    }
  }
}

Restart the client; the find_tools, describe_tool and execute_tool tools appear once it reconnects. See Authentication.

Verify it works

Ask your agent to do something it couldn’t before — for example:

Search X/Twitter for what people are saying about AgentKey today.

It should discover the right tool, look up its parameters, and run it. In clients with slash commands, /agentkey status checks the MCP connection, skill version and connectivity, and /agentkey setup re-runs setup. See Discover → Describe → Execute for how the flow works.

Update and uninstall

The hosted MCP server is always current. The skill checks for a new version on the first call of a session and offers to upgrade; force it with:

npx skills update agentkey

Claude Desktop keeps its own copy of the skill: re-import the latest agentkey.skill to update it there. To remove AgentKey from every agent — skill, MCP entry, key and caches:

curl -fsSL https://agentkey.app/uninstall.sh | bash

irm https://agentkey.app/uninstall.ps1 | iex

Skill and source


Source, releases, issues	github.com/chainbase-labs/Agentkey
`skills` CLI package	skills.sh/chainbase-labs/agentkey — `npx skills add chainbase-labs/agentkey`
ClawHub	clawhub.ai/chainbase/skills/agentkey — `openclaw skills install @chainbase/agentkey`
Claude Desktop skill file	agentkey.skill (latest release)
Hosted MCP server	`https://api.agentkey.app/v1/mcp`

Get Started

Core Concepts

Capabilities

Resources

Installation

One-line install (recommended)

Plugin marketplaces

Prompt install (chat agents)

Claude Desktop / Cowork (desktop config)

Any other MCP client

Verify it works

Update and uninstall

Skill and source

Next steps

Supported agents

Browse capabilities

​One-line install (recommended)

​Plugin marketplaces

​Prompt install (chat agents)

​Claude Desktop / Cowork (desktop config)

​Any other MCP client

​Verify it works

​Update and uninstall

​Skill and source

​Next steps

Supported agents

Browse capabilities

One-line install (recommended)

Plugin marketplaces

Prompt install (chat agents)

Claude Desktop / Cowork (desktop config)

Any other MCP client

Verify it works

Update and uninstall

Skill and source

Next steps