hio-client MCP Server
Allows resolving GitHub user profiles into cards, enabling the MCP server to fetch card markdown and structured data, and submit encrypted notes to the Human Is Offline platform for approval delegation.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
@humanisoffline/hio-client
Canonical Human Is Offline agent loop for npm and MCP.
Source repo for the public npm package. The hosted app lives in a separate private monorepo.
Install
npm install @humanisoffline/hio-clientRelated MCP server: handoff-attestor
API
import {
createHioClient,
buildAskFirstEnvelopeFromCard,
HIO_PROTOCOL_VERSION,
} from "@humanisoffline/hio-client";
const hio = createHioClient({ baseUrl: "https://humanisoffline.com" });
const resolved = await hio.resolveCard({
type: "github",
identifier: "octocat",
});
const markdown = await hio.fetchCardMarkdown(resolved.cardMarkdown);
const cardJson = await hio.fetchCardJson(resolved.cardJson);
const result = await hio.submitAskFirstNotePlaintext({
cardJson,
plaintext: {
schemaVersion: HIO_PROTOCOL_VERSION,
type: "inform",
title: "Need approval",
summary: "Deploy staging after tests pass.",
urgency: "normal",
riskLevel: "medium",
},
interpretedBoundary: {
outcome: "ask_first",
summary: "Deploy staging",
},
});
const receipt = await hio.getReceipt(result.receiptUrl);Lower-level envelope builder
If you already have card fields and the public encryption key:
import { buildAskFirstEnvelope } from "@humanisoffline/hio-client";
const envelope = buildAskFirstEnvelope({
cardSlug: "example",
cardUpdatedAt: "2026-07-12T12:00:00.000Z",
cardSchemaVersion: 3,
publicEncryptionKey: "…",
publicKeyId: "pk_…",
plaintext: { /* see agent-request.v3.json */ schemaVersion: 3, … },
});
await hio.submitAskFirstNote({ cardSlug: "example", envelope });Encryption uses sealed_box_v1 (NaCl box). Plaintext is never sent to the server.
MCP server
HIO_BASE_URL=https://humanisoffline.com npx @humanisoffline/hio-client hio-mcpOne agent loop via tools:
fetch_card_markdown— read authority from/c/{slug}.mdfetch_card_json— structured fields and encryption keyssubmit_ask_first_note— passcardJsonUrl+plaintext; encrypts and posts one inbox noteget_receipt— fetch delegation receipt JSON
Optional: resolve_card when the human shared an alias instead of a card URL.
submit_ask_first_note is the only submit path. It fetches card JSON, builds the sealed envelope, and stops after one POST.
Discovery: read /llms.txt on the configured base URL for routes and schemas.
Development
This repo uses a two-branch release model:
Branch | Role |
| Integration — open PRs here |
| Release line — version bumps and npm tags only |
Workflow
Branch from
develop, make changes, open a PR intodevelop.CI must pass (
cion Node 20 and 22, gitleaks, audit, build, tests).To release: bump
versioninpackage.jsonondevelop, open a PR intomain, merge.Tag the merge commit on
main:git tag v0.1.3 && git push origin v0.1.3.
The publish.yml workflow builds, tests, verifies the tag matches package.json, and publishes to npm with provenance.
npm run verifyNetwork access
This package makes outbound HTTPS requests to the configured Human Is Offline base URL (https://humanisoffline.com by default). It does not phone home elsewhere, collect telemetry, or run code at install time.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Read-only gateway for durable agent identity, consent, recognized work, and signed receipts.
Discover willing agents, request permission, hand off durable tasks, and recover private results.
Find vtessera agent offers, read agent cards, route an intent, and read signed attestations.
Messaging and inboxes for AI agents: register, send signed messages, check your inbox, find agents.
Related MCP Servers
- AlicenseAqualityCmaintenanceEnables AI agents to send and receive structured, cryptographically-verifiable messages, with tools for inbox management, task delegation, and agent discovery.12128 npmMIT
- AlicenseNot gradedqualityCmaintenanceEnables agents to issue and independently verify signed cross-agent handoff attestations, ensuring delegation scope only narrows, lifetimes stay contained, nonces resist replay, and chains stay continuous. Exposes tools for issuing handoffs, verifying them against constraints and ancestor linkage, checking scope containment, and describing the active key adapter.MIT
- FlicenseNot gradedqualityCmaintenanceProvides a stateless Agent Chat Protocol bridge that lets agents inspect proposed payments against policy, retrieve public signed receipts, and verify their cryptographic proofs without wallet or payment capabilities.-
- AlicenseNot gradedqualityCmaintenanceLets an agent manage local identities and public contact cards, and hide a message inside ordinary-looking cover text via concealment carriers, while inspecting and verifying sealed notes and encrypted capsules entirely on the user's own machine. Passphrases and plaintext stay in the companion CLI, and neither server has any outbound network capability.AGPL 3.0