README.md

June 18, 2026 · View on GitHub

HumanHours

HumanHours MCP Server

Every agent, measured in human hours.
humanhours.dev · MCP docs

Track agent ROI and enrich companies straight from any MCP client. HumanHours is a remote, hosted MCP server: connect once with your HumanHours account and your agents can log task events, read what they saved, and pull real labour-cost data for any company.

No installation, no API keys to copy around, no local process to run.

Connect

Endpointhttps://mcp.humanhours.dev/mcp
TransportStreamable HTTP
AuthOAuth 2.1 (PKCE) — browser login with your HumanHours account, approve workspace access

Add it to any client that supports remote MCP servers (Claude Desktop, claude.ai, Cursor, and others). On first use you complete a browser login and approve the scopes below; the client stores a token, so there are no keys to manage by hand.

Claude Desktop / claude.ai

Add a remote connector pointing at https://mcp.humanhours.dev/mcp and complete the login when prompted.

Cursor / other clients

{
  "mcpServers": {
    "humanhours": {
      "url": "https://mcp.humanhours.dev/mcp"
    }
  }
}

Tools

Logging

  • track_event — Record one agent task event and compute the hours and money it saved.

Reading

  • get_summary — Aggregated ROI for a period, with a daily trend.
  • time_saved_report — Hours saved, grouped by agent, task type, model, client, or time.
  • cost_saved_report — Money saved, grouped the same ways.
  • leaderboard — Top agents by a chosen metric.
  • get_usage — Event usage against the plan's included quota.
  • list_agents — Agents tracked, with 30-day hours and money saved.
  • list_task_types — Built-in plus custom task types.

Enrichment

  • enrich_company — Turn a domain into roles, per-hour wages, and an annual labour-cost case.
  • get_company — Read one enriched company from the library.
  • list_companies — List the workspace's company library, optionally by tag.
  • bulk_enrich — Queue a background job for many domains; returns a job id.
  • get_job — Check the status of a bulk enrichment job.

Scopes

ScopeGrants
track:writeLog task events
read:reportsRead ROI summaries, reports, leaderboards, usage
enrich:writeEnrich companies and read the company library

Docs

Full connection guide, scopes, and tool reference: https://humanhours.dev/docs/mcp

About

HumanHours is the ROI meter for AI agents: it measures the hours and money your agents save, and enriches companies with real wage data so every saving is grounded in what the work actually costs. Learn more at https://humanhours.dev.