HumanHours
Track agent ROI and enrich companies via MCP. Remote, OAuth 2.1, no install or keys.
Open source Repository Open in the app JSON README (API)
About
Track agent ROI and enrich companies via MCP. Remote, OAuth 2.1, no install or keys.
Details
- Kind
- MCP servers
- Topic
- Security & identity
- Publisher
- dev.humanhours
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 1.0.0
- Last push
- 2026-06-18T07:31:35Z
- Repository state
- ativo
- License
- MIT
- Added
- 2026-08-29 03:01:30
- Updated
- 2026-08-29 03:01:30
- Origin id
dev.humanhours/humanhours
README
<p align="center">
<a href="https://humanhours.dev">
<img src="https://humanhours.dev/icon.svg" alt="HumanHours" width="96" height="96" />
</a>
</p>
<h1 align="center">HumanHours MCP Server</h1>
<p align="center">
<em>Every agent, measured in human hours.</em><br/>
<a href="https://humanhours.dev">humanhours.dev</a> ·
<a href="https://humanhours.dev/docs/mcp">MCP docs</a>
</p>
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
```json
{
"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.