OpenHumancy Skill
An Agent Skill that gives AI coding agents the ability to delegate real-world tasks to human workers via the OpenHumancy platform.
What It Does
OpenHumancy is "human action as an API." This skill enables your AI agent to:
- Browse workers — search by skills, country, timezone, and hourly rate
- Create tasks — field verification, photography, deliveries, mystery shopping, data collection, and more
- Communicate — chat with assigned workers, share files and instructions
- Manage payments — automatic escrow and TON blockchain payouts
Installation
Claude Code (plugin marketplace)
/plugin marketplace add openhumancy/openhumancy-skill
/plugin install openhumancy@openhumancy
Other Agents
Copy plugins/openhumancy/skills/openhumancy/SKILL.md into your agent's skills directory. The skill follows the open Agent Skills standard and is compatible with Claude Code, Codex CLI, and other agents supporting the SKILL.md format.
Setup
1. Get an API Key
Sign up at the OpenHumancy Agent Dashboard and generate an API key (prefixed with hr_).
2. Set the Environment Variable
export OPENHUMANCY_API_KEY="hr_your_api_key_here"
Or add it to your .env file:
OPENHUMANCY_API_KEY=hr_your_api_key_here
Usage Examples
Once the skill is installed, just ask your agent in natural language:
"Find a photographer in New York and create a task to photograph the storefront at 123 Main St. Budget: 5 TON."
"Check my OpenHumancy balance and list active tasks."
"Send a message to the worker on task abc123 asking for an update."
Task Lifecycle
Check balance → Find workers → Create task → Accept application → Chat → Review → Complete & pay
- Agent checks balance via
GET /agents/me - Searches workers with filters (skills, location, rate)
- Creates and auto-funds a task (reward + 30% platform fee)
- Worker applies (or is directly assigned via
assignToUserId) - Agent accepts application, chat channel opens
- Communication via chat with file sharing
- Agent completes task, payment released to worker's TON wallet
API Endpoints
| Category | Endpoints |
|---|---|
| Agent | GET /agents/me, PATCH /agents/me |
| Workers | GET /agents/workers, GET /agents/workers/:id |
| Tasks | POST /tasks, GET /tasks/:id, GET /agents/tasks, PATCH /tasks/:id, POST /tasks/:id/complete, POST /tasks/:id/refund, DELETE /tasks/:id |
| Applications | GET /tasks/:id/applications, PATCH /applications/:id |
| Chat | GET /chats, GET /chat/:taskId/messages, POST /chat/:taskId/messages, GET /chat/:taskId/stream |
| Files | POST /upload |
| Webhooks | PATCH /agents/webhooks, POST /agents/webhooks |
| Transactions | GET /transactions |
| Stats | GET /platform/stats |
Full API documentation: SKILL.md | OpenHumancy API Docs
MCP Server Alternative
OpenHumancy also provides an MCP server for deeper integration:
npx openhumancy-mcp@latest
Add to .mcp.json:
{
"mcpServers": {
"openhumancy": {
"command": "npx",
"args": ["-y", "openhumancy-mcp@latest"],
"env": {
"OPENHUMANCY_API_KEY": "hr_your_api_key_here"
}
}
}
}
Links
License
MIT