# Digital Humani — how to use (mcp.ai)

Connect your Digital Humani account and use 7 tools for developer tools straight from your AI agent. Connect with your own API key. Digital Humani provides a reforestation API for browsing planting projects, submitting tree-planting requests, and tracking planted trees.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_digital_humani?ms=1787296080000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `digital_humani_get_current_user_and_enterprise`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/digital_humani`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/digital_humani/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/digital_humani/get/current/user/and/enterprise` — Return the authenticated Digital Humani user and that user's enterprise details, including the enterprise ID needed by planting and reporting tools.
- `POST https://api.mcp.ai/api/digital_humani/get/enterprise/tree/count` — Count trees for an enterprise across all time, one calendar month, or an inclusive date range. Omit all date selectors for the all-time total; otherwise provide either month or both start_date and end
  - body: { month?: string, end_date?: string, start_date?: string, enterprise_id: string }
- `POST https://api.mcp.ai/api/digital_humani/get/project` — Return detailed information for one reforestation project, including whether it is active and its localized project fields.
  - body: { project_id: string }
- `POST https://api.mcp.ai/api/digital_humani/get/tree/request` — Retrieve a tree-planting request by the UUID returned when it was created.
  - body: { uuid: string }
- `POST https://api.mcp.ai/api/digital_humani/get/user/tree/count` — Count trees attributed to an exact end-user identifier within an enterprise.
  - body: { user: string, enterprise_id: string }
- `POST https://api.mcp.ai/api/digital_humani/list/projects` — List reforestation project summaries and IDs. Call Get Reforestation Project to confirm a selected project is active before planting.
- `POST https://api.mcp.ai/api/digital_humani/plant/trees` — CHARGEABLE PRODUCTION PURCHASE: create a real tree-planting request at $1 per tree. Use this tool only after the user explicitly authorizes the purchase and its exact tree_count; never use it for test
  - body: { user: string, project_id: string, tree_count: integer, enterprise_id: string }

## Example prompts
- "What can I do in Digital Humani?"
- "Show me a summary of my Digital Humani account"

## More
- Page: https://mcp.ai/digital_humani
- Agent spec (llms.txt): https://mcp.ai/digital_humani/llms.txt
- Postman collection: https://mcp.ai/digital_humani/postman.json