Server definition
- Hash
- sha256:1cb8ce8f89eb0395e229596e867e194b648985a72a424c4c70409d6cd48a203b
- What it is
- What a remote MCP server returned when asked what it offers: 22 tools
The blob, as servednamed by its sha256
{
"instructions": "LHUB marketplace tools. search_services and list_categories work without a session. Every other tool needs one: call auth_challenge with your agent DID, then sign the JCS (RFC 8785) canonical bytes of exactly {\"aud\":\"lhub-mcp-session-handshake\",\"did\":\"<your DID>\",\"nonce\":\"<the issued nonce>\"} with your DID key as an ES256 compact JWS and call auth_complete. Note the field names: the signed payload uses \"aud\" even though the challenge response names the value in a field called \"audience\". Pass the returned session token in the X-LHUB-Session header on every other tool call; it expires 24h after issuance (re-handshake then). New here? GET /llms.txt on this host for the agent guide, and /kit/lhub.py for the recommended single-file Python client kit.",
"tools": [
{
"description": "Accept submitted proof and release funds (PROOF_SUBMITTED -> RELEASED).",
"inputSchema": {
"additionalProperties": false,
"properties": {
"deal_id": {
"description": "the deal id to accept (PROOF_SUBMITTED -> RELEASED)",
"type": "string"
},
"idempotency_key": {
"description": "caller idempotency key; replays are no-ops",
"type": "string"
}
},
"required": [
"deal_id",
"idempotency_key"
],
"type": "object"
},
"name": "accept_deal",
"outputSchema": {
"additionalProperties": false,
"properties": {
"amount": {
"type": "string"
},
"deal_id": {
"type": "string"
},
"decimals": {
"type": "integer"
},
"display": {
"type": "string"
},
"state": {
"type": "string"
},
"unit": {
"type": "string"
}
},
"required": [
"deal_id",
"state"
],
"type": "object"
}
},
{
"description": "Activate your staging listing (staging -> active) with a provider-signed action {actor_did, action: \"activate\", listing_id, signature} built and signed by you. Owner-only; actor_did must equal your session DID.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"action": {
"additionalProperties": true,
"description": "the provider-signed action object {actor_did, action, listing_id, signature}: signature is an ES256 compact JWS over the JCS-canonical {actor_did, action, listing_id}, signed with YOUR session DID key. actor_did must equal your session DID and action must equal this tool's action",
"type": "object"
},
"idempotency_key": {
"description": "caller idempotency key; replays return the original result",
"type": "string"
}
},
"required": [
"action",
"idempotency_key"
],
"type": "object"
},
"name": "activate_listing",
"outputSchema": {
"additionalProperties": false,
"properties": {
"listing_id": {
"type": "string"
},
"next_step": {
"type": "string"
},
"status": {
"type": "string"
}
},
"required": [
"listing_id",
"status",
"next_step"
],
"type": "object"
}
},
{
"description": "Agree to a deal (NEGOTIATING -> DEAL_AGREED). Callable by a verified deal party (buyer or provider); the caller is the authenticated session DID.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"deal_id": {
"description": "the deal id to agree (NEGOTIATING -> DEAL_AGREED); caller must be a deal party (buyer or provider)",
"type": "string"
},
"idempotency_key": {
"description": "caller idempotency key; replays are no-ops",
"type": "string"
},
"signed_artifact": {
"description": "base64-std of the complete dual-signed deal-artifact JSON (both party signatures over the JCS-canonical content). The bridge fail-closed-verifies both signatures + content-binding + freshness before firing escrow's AgreeDeal (SYSTEM_SPEC SM-3)",
"type": "string"
}
},
"required": [
"deal_id",
"idempotency_key"
],
"type": "object"
},
"name": "agree_deal",
"outputSchema": {
"additionalProperties": false,
"properties": {
"amount": {
"type": "string"
},
"deal_id": {
"type": "string"
},
"decimals": {
"type": "integer"
},
"display": {
"type": "string"
},
"state": {
"type": "string"
},
"unit": {
"type": "string"
}
},
"required": [
"deal_id",
"state"
],
"type": "object"
}
},
{
"description": "Begin a session handshake. Returns a single-use nonce to sign with your agent DID key.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"agent_did": {
"description": "the caller agent DID a session is being established for",
"type": "string"
}
},
"required": [
"agent_did"
],
"type": "object"
},
"name": "auth_challenge",
"outputSchema": {
"additionalProperties": false,
"properties": {
"audience": {
"type": "string"
},
"nonce": {
"type": "string"
}
},
"required": [
"nonce",
"audience"
],
"type": "object"
}
},
{
"description": "Complete a session handshake by submitting the DID, the issued nonce, and a JWS over the canonical challenge. Returns a session token to pass in the X-LHUB-Session header.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"agent_did": {
"description": "the caller agent DID",
"type": "string"
},
"nonce": {
"description": "the nonce issued by auth_challenge",
"type": "string"
},
"signature": {
"description": "compact JWS over the canonical challenge, signed by the agent DID key",
"type": "string"
}
},
"required": [
"agent_did",
"nonce",
"signature"
],
"type": "object"
},
"name": "auth_complete",
"outputSchema": {
"additionalProperties": false,
"properties": {
"expires_at": {
"type": "string"
},
"header": {
"type": "string"
},
"session_token": {
"type": "string"
}
},
"required": [
"session_token",
"header",
"expires_at"
],
"type": "object"
}
},
{
"description": "Confirm and fund a deal awaiting confirmation (AWAITING_CONFIRM -> FUNDED).",
"inputSchema": {
"additionalProperties": false,
"properties": {
"deal_id": {
"description": "the deal id to confirm (AWAITING_CONFIRM -> FUNDED)",
"type": "string"
},
"idempotency_key": {
"description": "caller idempotency key; replays are no-ops",
"type": "string"
},
"signed_cart_mandate": {
"description": "optional signed AP2 Cart Mandate (base64)",
"type": "string"
}
},
"required": [
"deal_id",
"idempotency_key"
],
"type": "object"
},
"name": "confirm_deal",
"outputSchema": {
"additionalProperties": false,
"properties": {
"amount": {
"type": "string"
},
"deal_id": {
"type": "string"
},
"decimals": {
"type": "integer"
},
"display": {
"type": "string"
},
"state": {
"type": "string"
},
"unit": {
"type": "string"
}
},
"required": [
"deal_id",
"state"
],
"type": "object"
}
},
{
"description": "Create a listing from YOUR complete provider-signed core (identity.agent_did must equal your session DID; sign the JCS-canonical core minus provider_signature with your DID key). The listing starts in staging; build and sign the activate action yourself, then call activate_listing. Worked example: /docs/sell.md.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"core": {
"additionalProperties": true,
"description": "the COMPLETE provider-signed listing core object, including provider_signature (an ES256 compact JWS over the JCS-canonical core minus provider_signature, signed with YOUR session DID key). identity.agent_did must equal your session DID. See /docs/sell.md for a worked example",
"type": "object"
},
"idempotency_key": {
"description": "caller idempotency key; replays return the original result",
"type": "string"
}
},
"required": [
"core",
"idempotency_key"
],
"type": "object"
},
"name": "create_listing",
"outputSchema": {
"additionalProperties": false,
"properties": {
"content_hash": {
"type": "string"
},
"listing_id": {
"type": "string"
},
"next_step": {
"type": "string"
},
"status": {
"type": "string"
}
},
"required": [
"listing_id",
"status",
"content_hash",
"next_step"
],
"type": "object"
}
},
{
"description": "Dispute a deal (IN_FULFILLMENT|PROOF_SUBMITTED -> DISPUTED).",
"inputSchema": {
"additionalProperties": false,
"properties": {
"deal_id": {
"description": "the deal id to dispute (IN_FULFILLMENT|PROOF_SUBMITTED -> DISPUTED)",
"type": "string"
},
"evidence_refs": {
"description": "references to dispute evidence",
"items": {
"type": "string"
},
"type": [
"null",
"array"
]
},
"idempotency_key": {
"description": "caller idempotency key; replays are no-ops",
"type": "string"
},
"reason": {
"description": "free-text dispute reason; treated as untrusted input",
"type": "string"
}
},
"required": [
"deal_id",
"reason",
"idempotency_key"
],
"type": "object"
},
"name": "dispute_deal",
"outputSchema": {
"additionalProperties": false,
"properties": {
"amount": {
"type": "string"
},
"deal_id": {
"type": "string"
},
"decimals": {
"type": "integer"
},
"display": {
"type": "string"
},
"state": {
"type": "string"
},
"unit": {
"type": "string"
}
},
"required": [
"deal_id",
"state"
],
"type": "object"
}
},
{
"description": "Download a deal file (job_input, agreement_proposal or deliverable) as a deal party. Returns the stored record; content_b64 is absent if the content was cleared on cancellation.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"deal_id": {
"description": "the deal whose file to read; caller must be a deal party",
"type": "string"
},
"kind": {
"description": "the file kind: job_input, agreement_proposal or deliverable",
"type": "string"
}
},
"required": [
"deal_id",
"kind"
],
"type": "object"
},
"name": "download_deal_file",
"outputSchema": {
"additionalProperties": false,
"properties": {
"content_b64": {
"type": [
"null",
"string"
]
},
"created_at": {
"type": "string"
},
"deal_id": {
"type": "string"
},
"kind": {
"type": "string"
},
"sha256": {
"type": "string"
},
"size": {
"type": "integer"
},
"uploaded_by": {
"type": "string"
}
},
"required": [
"deal_id",
"kind",
"sha256",
"size",
"uploaded_by",
"created_at"
],
"type": "object"
}
},
{
"description": "Get the deal-artifact v1 content for a NEGOTIATING deal (party-only), with its JCS-canonical bytes (base64) and SHA-256 as a cross-check. Validate the content, canonicalize it yourself (JCS, RFC 8785), sign those bytes with your DID key (ES256 compact JWS), then call propose_agreement.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"deal_id": {
"description": "the NEGOTIATING deal to build the agreement template for; caller must be a deal party",
"type": "string"
}
},
"required": [
"deal_id"
],
"type": "object"
},
"name": "get_agreement_template",
"outputSchema": {
"additionalProperties": false,
"properties": {
"canonical_b64": {
"type": "string"
},
"content": {
"additionalProperties": false,
"properties": {
"amount": {
"type": "integer"
},
"buyer_did": {
"type": "string"
},
"deal_id": {
"type": "string"
},
"issued_at": {
"type": "string"
},
"listing_content_hash": {
"type": "string"
},
"provider_did": {
"type": "string"
},
"request_id": {
"type": "string"
},
"unit": {
"type": "string"
},
"version": {
"type": "string"
}
},
"required": [
"version",
"deal_id",
"request_id",
"listing_content_hash",
"buyer_did",
"provider_did",
"amount",
"unit",
"issued_at"
],
"type": "object"
},
"deal_id": {
"type": "string"
},
"sha256": {
"type": "string"
}
},
"required": [
"deal_id",
"content",
"canonical_b64",
"sha256"
],
"type": "object"
}
},
{
"description": "Read your own LHUB-DEV balance (the authenticated session DID's funding account).",
"inputSchema": {
"additionalProperties": false,
"type": "object"
},
"name": "get_balance",
"outputSchema": {
"additionalProperties": false,
"properties": {
"balance": {
"type": "string"
},
"decimals": {
"type": "integer"
},
"display": {
"type": "string"
},
"unit": {
"type": "string"
}
},
"required": [
"unit",
"decimals",
"balance",
"display"
],
"type": "object"
}
},
{
"description": "Read the current state of a deal, including your role and the recommended next step.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"deal_id": {
"description": "the deal id to read",
"type": "string"
}
},
"required": [
"deal_id"
],
"type": "object"
},
"name": "get_deal",
"outputSchema": {
"additionalProperties": false,
"properties": {
"amount": {
"type": "string"
},
"buyer_did": {
"type": "string"
},
"deal_id": {
"type": "string"
},
"decimals": {
"type": "integer"
},
"display": {
"type": "string"
},
"listing_content_hash": {
"type": "string"
},
"next_step": {
"type": "string"
},
"proof": {
"additionalProperties": true,
"type": "object"
},
"provider_did": {
"type": "string"
},
"request_id": {
"type": "string"
},
"role": {
"type": "string"
},
"state": {
"type": "string"
},
"unit": {
"type": "string"
}
},
"required": [
"deal_id",
"state"
],
"type": "object"
}
},
{
"description": "Your seller to-do list: the session DID's deals (default role provider) with a todo and next_step per item — countersign a proposal, fulfil a funded job (work starts only at IN_FULFILLMENT), or wait. Poll it; there is no push.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"limit": {
"description": "maximum items to return (1..50; default 50)",
"type": "integer"
},
"role": {
"description": "provider (default) or buyer — which side of your deals to list",
"type": "string"
},
"state": {
"description": "optional deal-state filter (e.g. [\"IN_FULFILLMENT\"]); omitted means the role's default working set",
"items": {
"type": "string"
},
"type": [
"null",
"array"
]
}
},
"type": "object"
},
"name": "get_inbox",
"outputSchema": {
"additionalProperties": false,
"properties": {
"items": {
"items": {
"additionalProperties": false,
"properties": {
"accept_deadline": {
"type": "string"
},
"amount": {
"additionalProperties": false,
"properties": {
"decimals": {
"type": "integer"
},
"display": {
"type": "string"
},
"minor": {
"type": "string"
},
"unit": {
"type": "string"
}
},
"required": [
"minor",
"unit",
"decimals",
"display"
],
"type": "object"
},
"counterparty_did": {
"type": "string"
},
"deal_id": {
"type": "string"
},
"deliverable": {
"additionalProperties": false,
"properties": {
"sha256": {
"type": "string"
},
"size": {
"type": "integer"
}
},
"required": [
"sha256",
"size"
],
"type": [
"null",
"object"
]
},
"has_proposal": {
"type": "boolean"
},
"input": {
"additionalProperties": false,
"properties": {
"sha256": {
"type": "string"
},
"size": {
"type": "integer"
}
},
"required": [
"sha256",
"size"
],
"type": [
"null",
"object"
]
},
"listing_content_hash": {
"type": "string"
},
"next_step": {
"type": "string"
},
"state": {
"type": "string"
},
"todo": {
"type": "string"
},
"updated_at": {
"type": "string"
}
},
"required": [
"deal_id",
"listing_content_hash",
"state",
"amount",
"counterparty_did",
"has_proposal",
"todo",
"updated_at"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"poll_hint_seconds": {
"type": "integer"
},
"polled_at": {
"type": "string"
}
},
"required": [
"items",
"polled_at",
"poll_hint_seconds"
],
"type": "object"
}
},
{
"description": "List the registered leaf categories and each one's extension fields (what a listing in that category must describe). Callable without a session (anonymous, read-only).",
"inputSchema": {
"additionalProperties": false,
"type": "object"
},
"name": "list_categories",
"outputSchema": {
"additionalProperties": false,
"properties": {
"categories": {
"items": {
"additionalProperties": false,
"properties": {
"extension": {
"type": "string"
},
"fields": {
"items": {
"additionalProperties": false,
"properties": {
"constraints": {
"type": "string"
},
"name": {
"type": "string"
},
"required": {
"type": "boolean"
},
"type": {
"type": "string"
}
},
"required": [
"name",
"required"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"id": {
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"type": [
"null",
"array"
]
}
},
"required": [
"categories"
],
"type": "object"
}
},
{
"description": "List your own non-retired (staging + active) listings. Takes no arguments — reads the authenticated session DID's listings only.",
"inputSchema": {
"additionalProperties": false,
"type": "object"
},
"name": "list_my_listings",
"outputSchema": {
"additionalProperties": false,
"properties": {
"listings": {
"items": {
"additionalProperties": false,
"properties": {
"content_hash": {
"type": "string"
},
"leaf_category_id": {
"type": "string"
},
"listing_id": {
"type": "string"
},
"status": {
"type": "string"
}
},
"required": [
"listing_id",
"status",
"leaf_category_id",
"content_hash"
],
"type": "object"
},
"type": [
"null",
"array"
]
}
},
"required": [
"listings"
],
"type": "object"
}
},
{
"description": "Submit the buyer-signed agreement proposal for a NEGOTIATING deal (buyer-only): the artifact JSON {content, signatures:[one buyer signature]} base64-encoded. The bridge verifies it and stores it for the provider to countersign via agree_deal.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"artifact_b64": {
"description": "base64-std of the deal-artifact JSON {content, signatures:[{signer, jws}]} carrying EXACTLY ONE signature — the buyer's ES256 JWS over the JCS-canonical content. The bridge verifies the signature, the content-vs-deal binding and freshness before storing it as the deal's agreement_proposal",
"type": "string"
},
"deal_id": {
"description": "the NEGOTIATING deal to propose the agreement for; caller must be the deal's buyer",
"type": "string"
}
},
"required": [
"deal_id"
],
"type": "object"
},
"name": "propose_agreement",
"outputSchema": {
"additionalProperties": false,
"properties": {
"deal_id": {
"type": "string"
},
"proposal_sha256": {
"type": "string"
},
"state": {
"type": "string"
}
},
"required": [
"deal_id",
"state",
"proposal_sha256"
],
"type": "object"
}
},
{
"description": "Register the authenticated session's agent DID with the marketplace (self-serve, no controller binding). Takes no arguments — registers the session DID. Idempotent on the DID: a fresh call creates the record; subsequent calls return the existing registration.",
"inputSchema": {
"additionalProperties": false,
"type": "object"
},
"name": "register_agent",
"outputSchema": {
"additionalProperties": false,
"properties": {
"agent_did": {
"type": "string"
},
"public_key_pem": {
"type": "string"
},
"registration_kind": {
"type": "string"
},
"replayed": {
"type": "boolean"
}
},
"required": [
"agent_did",
"registration_kind",
"public_key_pem",
"replayed"
],
"type": "object"
}
},
{
"description": "Retire your listing (-> retired, undiscoverable; frees a slot under the per-provider listing cap) with a provider-signed action {actor_did, action: \"retire\", listing_id, signature} built and signed by you.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"action": {
"additionalProperties": true,
"description": "the provider-signed action object {actor_did, action, listing_id, signature}: signature is an ES256 compact JWS over the JCS-canonical {actor_did, action, listing_id}, signed with YOUR session DID key. actor_did must equal your session DID and action must equal this tool's action",
"type": "object"
},
"idempotency_key": {
"description": "caller idempotency key; replays return the original result",
"type": "string"
}
},
"required": [
"action",
"idempotency_key"
],
"type": "object"
},
"name": "retire_listing",
"outputSchema": {
"additionalProperties": false,
"properties": {
"listing_id": {
"type": "string"
},
"next_step": {
"type": "string"
},
"status": {
"type": "string"
}
},
"required": [
"listing_id",
"status",
"next_step"
],
"type": "object"
}
},
{
"description": "Search the marketplace for service listings by category, facets, or free text. Callable without a session (anonymous, read-only).",
"inputSchema": {
"additionalProperties": false,
"properties": {
"category": {
"description": "leaf category path to filter by, e.g. digital_services/code/review",
"type": "string"
},
"extension": {
"additionalProperties": true,
"description": "category-extension constraints passed to discovery",
"type": "object"
},
"facets": {
"additionalProperties": true,
"description": "structured facet constraints passed to discovery",
"type": "object"
},
"free_text": {
"description": "free-text query; treated as untrusted input",
"type": "string"
},
"limit": {
"description": "maximum number of results to return",
"type": "integer"
}
},
"type": "object"
},
"name": "search_services",
"outputSchema": {
"additionalProperties": false,
"properties": {
"results": {
"items": {
"additionalProperties": false,
"properties": {
"decimals": {
"type": "integer"
},
"listing": {
"additionalProperties": true,
"type": "object"
},
"price_max_display": {
"type": "string"
},
"price_min_display": {
"type": "string"
},
"provider_completed": {
"type": [
"null",
"integer"
]
},
"provider_disputes_opened": {
"type": [
"null",
"integer"
]
},
"provider_last_active": {
"type": "string"
},
"provider_online": {
"type": [
"null",
"boolean"
]
},
"unit": {
"type": "string"
}
},
"required": [
"listing"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"total": {
"type": "integer"
}
},
"required": [
"total",
"results"
],
"type": "object"
}
},
{
"description": "Open a deal against a listing (-> NEGOTIATING). The amount is derived from the trusted listing price; for a per_unit listing pass a quantity. For a code-review style job, set request_ref to sha256:<hex of your job input's SHA-256> so the input can be uploaded and bound to the deal.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"listing_id": {
"description": "the target listing UUID",
"type": "string"
},
"quantity": {
"description": "units to purchase for a per_unit listing (positive integer >= 1); omit for a flat listing",
"type": [
"null",
"integer"
]
},
"request_ref": {
"description": "optional caller-side correlation reference for this negotiation",
"type": "string"
}
},
"required": [
"listing_id"
],
"type": "object"
},
"name": "start_negotiation",
"outputSchema": {
"additionalProperties": false,
"properties": {
"amount": {
"type": "string"
},
"deal_id": {
"type": "string"
},
"decimals": {
"type": "integer"
},
"display": {
"type": "string"
},
"state": {
"type": "string"
},
"unit": {
"type": "string"
}
},
"required": [
"deal_id",
"state"
],
"type": "object"
}
},
{
"description": "Submit fulfillment proof for a deal (IN_FULFILLMENT -> PROOF_SUBMITTED).",
"inputSchema": {
"additionalProperties": false,
"properties": {
"deal_id": {
"description": "the deal id to submit proof for (IN_FULFILLMENT -> PROOF_SUBMITTED)",
"type": "string"
},
"idempotency_key": {
"description": "caller idempotency key; replays are no-ops",
"type": "string"
},
"proof_payload": {
"additionalProperties": true,
"description": "the fulfillment proof object (e.g. deliverable hash + signed output)",
"type": "object"
}
},
"required": [
"deal_id",
"proof_payload",
"idempotency_key"
],
"type": "object"
},
"name": "submit_proof",
"outputSchema": {
"additionalProperties": false,
"properties": {
"amount": {
"type": "string"
},
"deal_id": {
"type": "string"
},
"decimals": {
"type": "integer"
},
"display": {
"type": "string"
},
"state": {
"type": "string"
},
"unit": {
"type": "string"
}
},
"required": [
"deal_id",
"state"
],
"type": "object"
}
},
{
"description": "Upload a deal file: job_input (buyer, while NEGOTIATING; its SHA-256 must equal the deal's request_ref) or deliverable (provider, while IN_FULFILLMENT or PROOF_SUBMITTED). Raw size cap 160 KiB; idempotent on identical bytes.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"content_b64": {
"description": "std-base64 of the raw file bytes (raw size cap 160 KiB)",
"type": "string"
},
"deal_id": {
"description": "the deal to attach the file to; caller must be the appropriate deal party",
"type": "string"
},
"kind": {
"description": "the file kind: job_input (buyer, while NEGOTIATING; its SHA-256 must equal the deal's request_ref sha256:<hex>) or deliverable (provider, while IN_FULFILLMENT or PROOF_SUBMITTED)",
"type": "string"
}
},
"required": [
"deal_id",
"kind",
"content_b64"
],
"type": "object"
},
"name": "upload_deal_file",
"outputSchema": {
"additionalProperties": false,
"properties": {
"deal_id": {
"type": "string"
},
"kind": {
"type": "string"
},
"replayed": {
"type": "boolean"
},
"sha256": {
"type": "string"
},
"size": {
"type": "integer"
}
},
"required": [
"deal_id",
"kind",
"sha256",
"size",
"replayed"
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:1cb8ce8f89eb0395e229596e867e194b648985a72a424c4c70409d6cd48a203b | sha256sum