{"protocolVersion":"1.0","name":"Humwork","description":"Real-time consultation marketplace — connects AI agents with verified human domain experts (software, design, law, finance, medical, product) in under 60 seconds. Pay per consult in USDC via x402, subscribe with your wallet, or use a Humwork API key.","url":"https://api.humwork.ai","version":"0.1.0","provider":{"name":"Humwork","url":"https://humwork.ai"},"capabilities":{"streaming":true,"pushNotifications":false,"stateTransitionHistory":true},"defaultInputModes":["text"],"defaultOutputModes":["text"],"skills":[{"id":"consult_expert","name":"Consult a human expert","description":"Open a real-time chat session with a verified human expert in the requested domain. Returns a session_id usable by send_chat_message / close_chat / rate_chat.","tags":["consultation","expert","human"],"examples":["Need help debugging a Postgres query plan","Want a second opinion on a Series A term sheet","Stuck on a system-design decision for a chat backend"]},{"id":"send_chat_message","name":"Send a message in an active consult session","description":"Post a message to the expert in an open chat session.","tags":["chat","session"]},{"id":"close_chat","name":"End an active consult session","description":"Close the chat session and stop further billing.","tags":["chat","session"]},{"id":"rate_chat","name":"Rate a closed consult session","description":"Provide a 1–5 rating after a session ends.","tags":["chat","rating"]},{"id":"get_chat_messages","name":"Read the consult session history","description":"Fetch the message history for an active session — e.g. to read the expert's latest reply.","tags":["chat","session"]},{"id":"extend_session","name":"Extend an active consult session","description":"Add another time block to an open session before it expires.","tags":["chat","session"]},{"id":"subscribe_to_humwork","name":"Subscribe with a wallet","description":"Set up a wallet (x402/MPP) subscription for recurring consult credits.","tags":["subscription","billing","wallet"]}],"endpoints":{"mcp":"https://api.humwork.ai/api/v1","oauth_metadata":"https://api.humwork.ai/.well-known/oauth-authorization-server","plans":"https://api.humwork.ai/api/v1/users/plans","wallet_challenge":"https://api.humwork.ai/api/v1/users/me/wallet/challenge","wallet_transactions":"https://api.humwork.ai/api/v1/users/me/wallet/transactions","wallet_erase":"https://api.humwork.ai/api/v1/users/me/wallet/erase"},"payment":{"x402":{"enabled":true,"asset":"USDC","networks":[{"name":"base","caip2":"eip155:8453","asset":"USDC"},{"name":"solana","caip2":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","asset":"USDC"},{"name":"tempo","caip2":"tempo","asset":"USDC"}],"network":"base","paid_routes":[{"method":"POST","path":"/api/v1/tools/consult_expert","description":"Open a real-time consult with a human expert."},{"method":"POST","path":"/api/v1/tools/extend_session","description":"Extend an open consult by one chunk. The server embeds the x402 challenge in the SSE grace_period payload preceding this call, so the agent can attach X-PAYMENT to the first extend_session request — no separate 402 round trip.","challenge_delivery":"embedded_in_grace_period"}],"aggregator_hint":{"name":"LI.FI","url":"https://li.quest/v1","rationale":"Aggregates 30+ bridges/DEXs across 60+ chains. Server-side REST API. Use only on the agent side; Humwork itself does not orchestrate swaps."},"supported_metadata_keys":["operator_email","operator_handle","agent_name","purpose"]},"mpp":{"enabled":true,"spec":"draft-httpauth-payment-00","spec_url":"https://paymentauth.org","scheme":"Payment","transport":"http","asset":"USDC","networks":[{"name":"solana","caip2":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","asset":"USDC"},{"name":"tempo","caip2":"tempo","asset":"USDC"}],"methods":["stripe"],"intents":["charge","subscribe"],"subscription":{"tool":"subscribe_to_humwork","tiers_endpoint":"https://api.humwork.ai/api/v1/users/wallet-subscription-tiers","cancel_endpoint":"https://api.humwork.ai/api/v1/users/me/wallet/subscription/cancel","period_days":30,"after_activation_auth":"X-API-Key: hkw_*"},"paid_routes":[{"method":"POST","path":"/api/v1/tools/consult_expert","description":"Open a real-time consult with a human expert. Server emits WWW-Authenticate: Payment headers; client signs and retries with Authorization: Payment. Successful responses carry a Payment-Receipt header."},{"method":"POST","path":"/api/v1/tools/extend_session","description":"Extend an open consult by one chunk."}],"aggregator_hint":{"name":"LI.FI","url":"https://li.quest/v1","rationale":"Aggregates 30+ bridges/DEXs across 60+ chains. Server-side REST API. Use only on the agent side; Humwork itself does not orchestrate swaps."},"realm":"humwork.ai"},"api_key":{"scheme":"Bearer hk_* | hkw_*","header":"Authorization","prefixes":{"hk_":"human Stripe subscriber","hkw_":"wallet subscriber (minted by subscribe_to_humwork)"}}},"self_service":{"description":"Wallet users have no Auth0 / email — identity is the wallet. To read receipts or request GDPR erasure, sign a server-issued nonce. Pure read paths, no session cookie.","flow":["POST /api/v1/users/me/wallet/challenge { wallet_address }","Sign the returned `message` with your wallet (EIP-191 personal_sign)","POST /api/v1/users/me/wallet/transactions { wallet_address, nonce, signature }"]}}