streamable-httpMITupdated 2mo ago
Every agent, measured in human hours. humanhours.dev ยท MCP docs
What can you do with HumanHours?
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
| Endpoint | https://mcp.humanhours.dev/mcp |
| Transport | Streamable HTTP |
| Auth | OAuth 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
| Scope | Grants |
|---|---|
track:write |
Log task events |
read:reports |
Read ROI summaries, reports, leaderboards, usage |
enrich:write |
Enrich 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.
Install
Add HumanHours to your client. Pick the one you use.
claude mcp add --transport http humanhours https://mcp.humanhours.dev/mcpcodex mcp add humanhours --url https://mcp.humanhours.dev/mcp{
"mcpServers": {
"humanhours": {
"url": "https://mcp.humanhours.dev/mcp"
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
{
"servers": {
"humanhours": {
"type": "http",
"url": "https://mcp.humanhours.dev/mcp"
}
}
}Add to `.vscode/mcp.json` in your workspace.
{
"mcpServers": {
"humanhours": {
"url": "https://mcp.humanhours.dev/mcp"
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"humanhours": {
"serverUrl": "https://mcp.humanhours.dev/mcp"
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
12 tools
HumanHours exposes 12 tools to a connected agent.
- track_event
- Record one agent task event and compute the hours and money it saved.
- 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.
- 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.
- 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.
Score
71 / 100
Good
- Documentation22/25
- Maintenance16/25
- Trust13/20
- Capability8/15
- Install experience12/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 75 days ago
- Has a release history
- Repository is not archived
- Licensed MIT
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 12 tool(s) documented
- Provides prompt templates
- Provides resources
- 6 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint โ no local install
Version history
| Versions | Published |
|---|---|
| 1.0.0Latest | Jun 18, 2026 |