skills.md
Are you an agent?

MCP Reference

Run the public skills-mcp process with the Skills.md profile described in Agent Integrations. MCP tools/list returns the installed tool names and input schemas. These are MCP operations, not HTTP endpoint paths.

Hosted customer tools

ToolPurpose
get_server_capabilitiesRead the selected server's supported API contract.
get_accountRead the signed-in customer identity.
list_remote_skillsRead the hosted catalog and availability.
quote_skillQuote name with optional input and args, without submitting work.
run_skillSubmit with remote: true, approved maxCredits, and optional idempotency_key.
get_run_status / get_run_logsRead the selected organization's run and logs.
list_run_artifactsList authenticated artifact metadata for run_id.
download_run_artifactReturn verified bytes as base64 for run_id and artifact_id, up to 1 MiB.
get_billing_status / get_billing_usageRead credit balance and usage.
list_credit_packsDiscover pack IDs.
create_credit_checkoutCreate a customer checkout link for pack_id.
list_invoices / create_billing_portalRead invoice history or open account management.

cancel_run and resume_run are state-dependent and may be refused. Key management (list_api_keys, create_api_key, revoke_api_key) requires fresh email/code reauthentication. Missing server capabilities return errors.

Approve paid work

Call quote_skill with name: "blog-article" and the requested input. Show the returned credit quote to the user before passing that approved amount as maxCredits to run_skill. Keep the input unchanged between approval and submission. The server rejects a higher admission price before reserving credits.

Checkout tools return a link. The customer reviews and completes payment in the browser; the agent must not infer payment from a created link or redirect.

Download output

For files larger than the MCP limit, use skills --profile skills-md exports download <run-id> --json. The client checks size and SHA-256 metadata and protects existing files from overwrite. MCP's base64 response is not itself a saved file; report a local path only after the host has written it.

Local OSS tools

The public server also exposes local discovery and authoring tools. list_skills, get_skill_docs and the skills://registry resource describe the local corpus; get_skill_docs does not fetch documentation for a hosted-only skill. Use list_remote_skills for the selected hosted catalog and its web documentation for a hosted skill's usage contract. Do not substitute this private product's legacy MCP inventory for the public package's actual tools/list response.

bun install -g @hasna/skills && HASNA_SKILLS_API_URL=https://skills.md skills --profile skills-md auth signup