hive-credentials

Setup Credentials

Interactive credential setup for agents with multiple authentication options. Detects what's missing, offers auth method choices, validates with health checks, and stores credentials securely.

When to Use

• Before running or testing an agent for the first time
• When AgentRunner.run() fails with "missing required credentials"
• When a user asks to configure credentials for an agent
• After building a new agent that uses tools requiring API keys

Workflow

Step 1: Identify the Agent

Determine which agent needs credentials. The user will either:

• Name the agent directly (e.g., "set up credentials for hubspot-agent")
• Have an agent directory open (check exports/ for agent dirs)
• Be working on an agent in the current session

Locate the agent's directory under exports/{agent_name}/.

Step 2: Detect Missing Credentials

Use the check_missing_credentials MCP tool to detect what the agent needs and what's already configured. This tool loads the agent, inspects its required tools and node types, maps them to credentials via CREDENTIAL_SPECS, and checks both the encrypted store and environment variables.

check_missing_credentials(agent_path="exports/{agent_name}")

The tool returns a JSON response:

{
  "agent": "exports/{agent_name}",
  "missing": [
    {
      "credential_name": "brave_search",
      "env_var": "BRAVE_SEARCH_API_KEY",
      "description": "Brave Search API key for web search",
      "help_url": "https://brave.com/search/api/",
      "tools": ["web_search"]
    }
  ],
  "available": [
    {
      "credential_name": "anthropic",
      "env_var": "ANTHROPIC_API_KEY",
      "source": "encrypted_store"
    }
  ],
  "total_missing": 1,
  "ready": false
}

If ready is true (nothing missing): Report all credentials as configured and skip Steps 3-5. Example:

All required credentials are already configured:
  ✓ anthropic (ANTHROPIC_API_KEY)
  ✓ brave_search (BRAVE_SEARCH_API_KEY)
Your agent is ready to run!