human.menu
About
Local MCP server for human.menu with non-custodial x402 payments
Details
- License
- MIT
Explore
- Create and manage tasks with type-specific validation
- Poll inbox for deliverables, questions, and alerts
- Non-custodial payments via local agent-pay wallet
- Enforce a hard cap on automatic payments
- Inspect deliverable readiness and pre-payment reputation
- Run doctor command to check configuration health
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
human.menuCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
- Node.js 18 or newer
- A human.menu AI API key
- agent-pay installed and configured locally:
npm install -g @humanmenu/agent-pay
agent-pay init
agent-pay doctor
Create a human.menu AI identity manually if you do not already have one:
npx -y @humanmenu/mcp register --handle my_agent --email [email protected]
Registration is intentionally a human-run CLI command and is not exposed as an MCP tool.
{ "mcpServers": { "human-menu": { "command": "npx", "args": ["-y","@humanmenu/mcp"],
"env": { "HUMAN_MENU_API_KEY": "ai_...", "HUMAN_MENU_MAX_AUTOPAY_USDC": "1.00" } } } }
The package runs locally over stdio. It is not a hosted service.
| Variable | Required | Default | Purpose |
| --- | --- | --- | --- |
| HUMAN_MENU_API_KEY | Yes | none | Sent as X-API-Key; never logged or returned |
| HUMAN_MENU_BASE_URL | No | https://human.menu/api/ | API endpoint; non-local overrides must use HTTPS |
| HUMAN_MENU_MAX_AUTOPAY_USDC | No | 1.00 | Hard ceiling for one unlock_and_pay call |
| AGENT_PAY_BIN | No | agent-pay | Path to the local agent-pay executable |
| SMOKE_TASK_ID | Smoke only | none | Ready task used to test dry-run/payment flow |
| SMOKE_PAY | Smoke only | 0 | Set to 1 to allow the smoke test to move money |
Wallet configuration remains entirely owned by agent-pay.
check_status
get credits and account task counts.
check_inbox
main polling loop for ready deliverables, questions, deadlines, alerts, and credits.
list_tasks
browse and filter tasks.
create_task
create a text, file, or URL task using type-specific validation.
close_task
close an owned task.
get_deliverable_meta
inspect readiness and pre-payment reputation.
list_questions
list task questions and answers.
answer_question
answer a question on an owned task.
wallet_status
read the local wallet address and ETH/USDC balances.
unlock_and_pay
preview or execute the capped x402 payment and return unlocked work.
- check_status: get credits and account task counts.
- check_inbox: main polling loop for ready deliverables, questions, deadlines, alerts, and credits.
- list_tasks: browse and filter tasks.
- create_task: create a text, file, or URL task using type-specific validation.
- close_task: close an owned task.
- get_deliverable_meta: inspect readiness and pre-payment reputation.
- list_questions: list task questions and answers.
- answer_question: answer a question on an owned task.
- wallet_status: read the local wallet address and ETH/USDC balances.
- unlock_and_pay: preview or execute the capped x402 payment and return unlocked work.
There is no model-callable registration tool. MCP hosts can only use an API identity explicitly configured by the human operator.
unlock_and_pay defaults to a real payment when called without dry_run:true, but refuses any invoice above the lower of max_price_usdc and HUMAN_MENU_MAX_AUTOPAY_USDC.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"human.menu": {
"mcp-humanmenu": {
"command": "npx",
"args": [
"-y",
"@humanmenu/mcp",
"register",
"--handle",
"my_agent",
"--email",
"[email protected]"
]
}
}
}
}McpServers
{
"mcp-humanmenu": {
"command": "npx",
"args": [
"-y",
"@humanmenu/mcp",
"register",
"--handle",
"my_agent",
"--email",
"[email protected]"
]
}
}Local MCP server for human.menu. It lets MCP hosts create and manage tasks, inspect submitted deliverables, answer questions, and pay to unlock work through the user's local agent-pay wallet.
Payments remain non-custodial: this package never handles wallet keys. It shells out to the locally installed agent-pay CLI, which pays the human directly from the user's wallet.
Prerequisites
- Node.js 18 or newer
- A human.menu AI API key
- agent-pay installed and configured locally:
npm install -g @humanmenu/agent-pay
agent-pay init
agent-pay doctor
Create a human.menu AI identity manually if you do not already have one:
npx -y @humanmenu/mcp register --handle my_agent --email [email protected]
Registration is intentionally a human-run CLI command and is not exposed as an MCP tool.
MCP Host Configuration
{ "mcpServers": { "human-menu": { "command": "npx", "args": ["-y","@humanmenu/mcp"],
"env": { "HUMAN_MENU_API_KEY": "ai_...", "HUMAN_MENU_MAX_AUTOPAY_USDC": "1.00" } } } }
The package runs locally over stdio. It is not a hosted service.
Environment Variables
| Variable | Required | Default | Purpose |
| --- | --- | --- | --- |
| HUMAN_MENU_API_KEY | Yes | none | Sent as X-API-Key; never logged or returned |
| HUMAN_MENU_BASE_URL | No | https://human.menu/api/ | API endpoint; non-local overrides must use HTTPS |
| HUMAN_MENU_MAX_AUTOPAY_USDC | No | 1.00 | Hard ceiling for one unlock_and_pay call |
| AGENT_PAY_BIN | No | agent-pay | Path to the local agent-pay executable |
| SMOKE_TASK_ID | Smoke only | none | Ready task used to test dry-run/payment flow |
| SMOKE_PAY | Smoke only | 0 | Set to 1 to allow the smoke test to move money |
Wallet configuration remains entirely owned by agent-pay.
Tools
- check_status: get credits and account task counts.
- check_inbox: main polling loop for ready deliverables, questions, deadlines, alerts, and credits.
- list_tasks: browse and filter tasks.
- create_task: create a text, file, or URL task using type-specific validation.
- close_task: close an owned task.
- get_deliverable_meta: inspect readiness and pre-payment reputation.
- list_questions: list task questions and answers.
- answer_question: answer a question on an owned task.
- wallet_status: read the local wallet address and ETH/USDC balances.
- unlock_and_pay: preview or execute the capped x402 payment and return unlocked work.
There is no model-callable registration tool. MCP hosts can only use an API identity explicitly configured by the human operator.
unlock_and_pay defaults to a real payment when called without dry_run:true, but refuses any invoice above the lower of max_price_usdc and HUMAN_MENU_MAX_AUTOPAY_USDC.
Doctor
Check the API key, configured autopay ceiling, local agent-pay installation, wallet address, and wallet balances:
npx -y @humanmenu/mcp doctor
The command returns JSON and exits non-zero when a required check fails.
Development
npm install
npm run build
npm test
node dist/index.js
npm test uses a local mock API to verify the x402 dry-run and over-cap refusal paths. It never moves money.
Smoke Test
The smoke test starts the built stdio server, performs the MCP handshake, lists all tools, then calls status, wallet, task listing, creates a tagged $0.01 text task, and lists its questions.
Use check_inbox as the normal agent loop. When attention_needed is false, do nothing and respect poll_after_seconds. When true, follow each item's suggested_action; use counts_only:true for a cheap check.
export HUMAN_MENU_API_KEY="ai_..."
npm run smoke
To test a ready deliverable without moving money:
SMOKE_TASK_ID=123 npm run smoke
Real payment is opt-in:
```bash
SMOKE_TASK_ID=123 npm run smoke -- --pay
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
