{"data":{"name":"dev.mcphost/mcphost","title":null,"description":"Hosted MCP runtime where your agent publishes its own tools by tool call and keeps working.","version":"0.130.19","websiteUrl":"https://mcphost.dev","repositoryUrl":"https://github.com/j0yen/mcphost","remotes":[{"type":"streamable-http","url":"https://mcphost.dev/mcp"}],"packages":[],"status":"active","isLatest":true,"publishedAt":"2026-11-14T12:24:30.537Z","updatedAt":"2026-11-14T12:24:30.537Z","source":"official-registry","verification":"official","confidence":100,"stars":null,"sources":[{"source":"official-registry","sourceId":"dev.mcphost/mcphost","verification":"official","confidence":100,"stars":null,"updatedAt":"2026-11-14T12:24:30.537Z","title":null,"description":"Hosted MCP runtime where your agent publishes its own tools by tool call and keeps working.","websiteUrl":"https://mcphost.dev","repositoryUrl":"https://github.com/j0yen/mcphost"}],"toolIndex":{"tools":[{"serverName":"dev.mcphost/mcphost","endpointFingerprint":"d0a85c5b48c06d69a4304726a2ca9da9d2546be8de456500be18628faebeec33","name":"billing.plans","title":null,"description":"The plan catalog (price and quotas per plan) and whether Stripe billing is configured on this host. Anonymous callers get the same answer as tenants.","inputSchema":{"type":"object","properties":{"tenant_key":{"description":"The key `signup` returned. Optional on the connection that ran signup (or host.redeem): that connection is already bound to the tenant it created, so later calls on it need no tenant_key. On a connection with no Authorization: Bearer header and no prior signup, omitting it implicitly signs that connection up as a brand-new tenant and runs this call as it -- see host.whoami's source field. When both a header and this argument are present, the header wins.","type":"string"}},"required":[],"additionalProperties":false,"x-mcphost-validated":true},"annotations":null,"definitionHash":"cbfab6d8a73a4c093895af50c05612d62267675144073704bca9abb81e7b7f09","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T19:47:38.304Z","metadataTrust":"untrusted"},{"serverName":"dev.mcphost/mcphost","endpointFingerprint":"d0a85c5b48c06d69a4304726a2ca9da9d2546be8de456500be18628faebeec33","name":"host.errors","title":null,"description":"List every error code this host can return, each with its class (agent_fault | host_refusal | upstream_fault | plan_limit | host_fault), family, remedy, docs anchor, retryable flag and help_url -- the same object GET /errors.json serves. Pass code to get one row; a misspelt code answers tool_not_found with did_you_mean. Read-only, anonymous, no tenant data.","inputSchema":{"type":"object","properties":{"code":{"description":"An error code, e.g. tool_exception. Omit to list every code.","type":"string"},"tenant_key":{"description":"The key `signup` returned. Optional on the connection that ran signup (or host.redeem): that connection is already bound to the tenant it created, so later calls on it need no tenant_key. On a connection with no Authorization: Bearer header and no prior signup, omitting it implicitly signs that connection up as a brand-new tenant and runs this call as it -- see host.whoami's source field. When both a header and this argument are present, the header wins.","type":"string"}},"required":[],"additionalProperties":false,"x-mcphost-validated":true},"annotations":null,"definitionHash":"3d53f3bbbf68094ac6de1d6b78142644ead464c4a48c6a33716af0f92e962155","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T19:47:38.304Z","metadataTrust":"untrusted"},{"serverName":"dev.mcphost/mcphost","endpointFingerprint":"d0a85c5b48c06d69a4304726a2ca9da9d2546be8de456500be18628faebeec33","name":"host.feedback.list","title":null,"description":"List your own feedback (newest first, status received). Anonymous callers get [].","inputSchema":{"type":"object","properties":{"limit":{"description":"Max rows, up to 100; default 20.","type":"integer"},"tenant_key":{"description":"The key `signup` returned. Optional on the connection that ran signup (or host.redeem): that connection is already bound to the tenant it created, so later calls on it need no tenant_key. On a connection with no Authorization: Bearer header and no prior signup, omitting it implicitly signs that connection up as a brand-new tenant and runs this call as it -- see host.whoami's source field. When both a header and this argument are present, the header wins.","type":"string"}},"required":[],"additionalProperties":false,"x-mcphost-validated":true},"annotations":null,"definitionHash":"3caacc26ef224387f5613f8397c7869c45edaa9f7a0215763114b4370525966e","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T19:47:38.304Z","metadataTrust":"untrusted"},{"serverName":"dev.mcphost/mcphost","endpointFingerprint":"d0a85c5b48c06d69a4304726a2ca9da9d2546be8de456500be18628faebeec33","name":"host.feedback.send","title":null,"description":"Tell the host's humans what you needed: kind, up to 2048 bytes of text, optional context. Works before signup. Returns feedback_id.","inputSchema":{"type":"object","properties":{"context":{"description":"Optional, at most 1 KB: tool, error_code, free.","type":"object"},"kind":{"description":"What you are telling the host.","enum":["missing_tool","wrong_error","docs_gap","bug","praise"],"type":"string"},"tenant_key":{"description":"The key `signup` returned. Optional on the connection that ran signup (or host.redeem): that connection is already bound to the tenant it created, so later calls on it need no tenant_key. On a connection with no Authorization: Bearer header and no prior signup, omitting it implicitly signs that connection up as a brand-new tenant and runs this call as it -- see host.whoami's source field. When both a header and this argument are present, the header wins.","type":"string"},"text":{"description":"What you needed or saw; 1 to 2048 bytes after trim.","minLength":1,"type":"string"}},"required":["kind","text"],"additionalProperties":false,"x-mcphost-validated":true},"annotations":null,"definitionHash":"e80984fc3feebfaad03d034c05767b3e5fa548d3b7ebb0df6511b3d0ea8361ed","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T19:47:38.304Z","metadataTrust":"untrusted"},{"serverName":"dev.mcphost/mcphost","endpointFingerprint":"d0a85c5b48c06d69a4304726a2ca9da9d2546be8de456500be18628faebeec33","name":"host.help.get","title":null,"description":"Return the documentation section an anchor points at: its text (at most 4 KB) and its first fenced example. Pass an anchor exactly as an error, hint or help entry printed it, e.g. a rate_limited error's `anchor`. Read-only, anonymous, no tenant data. An unknown anchor is anchor_not_found with the nearest anchors in did_you_mean.","inputSchema":{"type":"object","properties":{"anchor":{"description":"A `<path>#<slug>` anchor, e.g. README.md#call-limits, as printed by an error's `anchor` field or a `host.help.search` hit. `<path>#top` and a bare `<path>` (e.g. docs/kinds/chain.md) both return that document's first section.","type":"string"},"tenant_key":{"description":"The key `signup` returned. Optional on the connection that ran signup (or host.redeem): that connection is already bound to the tenant it created, so later calls on it need no tenant_key. On a connection with no Authorization: Bearer header and no prior signup, omitting it implicitly signs that connection up as a brand-new tenant and runs this call as it -- see host.whoami's source field. When both a header and this argument are present, the header wins.","type":"string"}},"required":["anchor"],"additionalProperties":false,"x-mcphost-validated":true},"annotations":null,"definitionHash":"c1356760bf70573a7370dc188b274099e77d593f5a406404e519163f559959c8","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T19:47:38.304Z","metadataTrust":"untrusted"},{"serverName":"dev.mcphost/mcphost","endpointFingerprint":"d0a85c5b48c06d69a4304726a2ca9da9d2546be8de456500be18628faebeec33","name":"host.help.search","title":null,"description":"Search this host's own documentation and tool descriptions. Returns up to k hits (default 3, response under 2 KB), each with a snippet, the nearest runnable example and an anchor. Read-only, anonymous, no tenant data -- call it with the error text or import line you are stuck on before reading any docs file.","inputSchema":{"type":"object","properties":{"k":{"default":3,"description":"How many hits to return (default 3).","maximum":5,"minimum":1,"type":"integer"},"kind":{"description":"Only search the page of this registered kind (docs/kinds/<kind>.md).","enum":["chain","echo","http","jq","js","python","wasm"],"type":"string"},"q":{"description":"What you are stuck on: a tool name, an error code or message, an import line.","type":"string"},"tenant_key":{"description":"The key `signup` returned. Optional on the connection that ran signup (or host.redeem): that connection is already bound to the tenant it created, so later calls on it need no tenant_key. On a connection with no Authorization: Bearer header and no prior signup, omitting it implicitly signs that connection up as a brand-new tenant and runs this call as it -- see host.whoami's source field. When both a header and this argument are present, the header wins.","type":"string"}},"required":["q"],"additionalProperties":false,"x-mcphost-validated":true},"annotations":null,"definitionHash":"396480be908c106ad1f15fa85cfa8b6d4947cd8f8767beaafcd3737f1e77fe82","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T19:47:38.304Z","metadataTrust":"untrusted"},{"serverName":"dev.mcphost/mcphost","endpointFingerprint":"d0a85c5b48c06d69a4304726a2ca9da9d2546be8de456500be18628faebeec33","name":"host.quickstart","title":null,"description":"Return the shortest ordered sequence of calls to a working tool of `kind`, with your namespace and a filled-in example already substituted in, plus the current limits and a try_before_call table naming the one dry-run tool for each case. Read-only -- this call alone never creates a tenant. Call this before host.tool_publish if you're not sure what a spec should look like. Unauthenticated callers get a worked example with no tenant data; any other host.*/billing.* call creates a tenant on first use, no signup required.","inputSchema":{"type":"object","properties":{"kind":{"description":"Which registered kind to return a worked example for, e.g. echo, http, python -- or a job-word alias (webhook, event, cron, ...) for its recipe. Omit to see every kind, alias and recipe name.","type":"string"},"retry_after_s":{"description":"Seconds a rate-limited signup said to wait; an error's next_call carries it back here. Informational, never required.","type":"integer"},"tenant_key":{"description":"The key `signup` returned. Optional on the connection that ran signup (or host.redeem): that connection is already bound to the tenant it created, so later calls on it need no tenant_key. On a connection with no Authorization: Bearer header and no prior signup, omitting it implicitly signs that connection up as a brand-new tenant and runs this call as it -- see host.whoami's source field. When both a header and this argument are present, the header wins.","type":"string"}},"required":[],"additionalProperties":false,"x-mcphost-validated":true},"annotations":null,"definitionHash":"c361a118bebdcdd5416bd2677af704fd70335a9f3bc1550995c0a1a411a655c7","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T19:47:38.304Z","metadataTrust":"untrusted"},{"serverName":"dev.mcphost/mcphost","endpointFingerprint":"d0a85c5b48c06d69a4304726a2ca9da9d2546be8de456500be18628faebeec33","name":"host.redeem","title":null,"description":"Exchange a signup(handoff: true) handoff_token for the tenant key it was issued for. Single-use: a second redemption fails with handoff_token_redeemed; past its expiry it fails with handoff_token_expired. Unauthenticated -- the token itself is the proof.","inputSchema":{"type":"object","properties":{"handoff_token":{"description":"The handoff_token signup(handoff: true) returned.","type":"string"},"tenant_key":{"description":"The key `signup` returned. Optional on the connection that ran signup (or host.redeem): that connection is already bound to the tenant it created, so later calls on it need no tenant_key. On a connection with no Authorization: Bearer header and no prior signup, omitting it implicitly signs that connection up as a brand-new tenant and runs this call as it -- see host.whoami's source field. When both a header and this argument are present, the header wins.","type":"string"}},"required":["handoff_token"],"additionalProperties":false,"x-mcphost-validated":true},"annotations":null,"definitionHash":"77ef9a1c14266cda89bc8445cb5daa5a2a96161ef1e78620cc2842f9ec5de984","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T19:47:38.304Z","metadataTrust":"untrusted"},{"serverName":"dev.mcphost/mcphost","endpointFingerprint":"d0a85c5b48c06d69a4304726a2ca9da9d2546be8de456500be18628faebeec33","name":"host.resume","title":null,"description":"Resume where you left off in one call (at most 4096 bytes): your tools with each one's last call status, unfinished runs, your newest notes, what changed on the host since your last call, and one suggested next_call. truncated names any section that was cut -- call that section's own tool (host.tool.list, host.runs.list, host.note.list, host.changelog) for the rest. Read-only. An unauthenticated caller gets the onboarding block and creates no tenant.","inputSchema":{"type":"object","properties":{"tenant_key":{"description":"The key `signup` returned. Optional on the connection that ran signup (or host.redeem): that connection is already bound to the tenant it created, so later calls on it need no tenant_key. On a connection with no Authorization: Bearer header and no prior signup, omitting it implicitly signs that connection up as a brand-new tenant and runs this call as it -- see host.whoami's source field. When both a header and this argument are present, the header wins.","type":"string"}},"required":[],"additionalProperties":false,"x-mcphost-validated":true},"annotations":null,"definitionHash":"c8547c1fe1db8b9ff22190ba5cf1a17a861e72d746c797b5ade0f4228cd973a1","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T19:47:38.304Z","metadataTrust":"untrusted"},{"serverName":"dev.mcphost/mcphost","endpointFingerprint":"d0a85c5b48c06d69a4304726a2ca9da9d2546be8de456500be18628faebeec33","name":"host.state.get","title":null,"description":"Read one key from this tenant's key-value state namespace. Returns found: false (not an error) if the key was never set.","inputSchema":{"type":"object","properties":{"end_user":{"description":"\"self\" for the caller's own verified end-user identity, an explicit subject (only when this call carries no end-user identity of its own), or omit/null for the tenant-wide value.","type":["string","null"]},"key":{"description":"Key to read from this tenant's key-value state namespace.","type":"string"},"tenant_key":{"description":"The key `signup` returned. Optional on the connection that ran signup (or host.redeem): that connection is already bound to the tenant it created, so later calls on it need no tenant_key. On a connection with no Authorization: Bearer header and no prior signup, omitting it implicitly signs that connection up as a brand-new tenant and runs this call as it -- see host.whoami's source field. When both a header and this argument are present, the header wins.","type":"string"}},"required":["key"],"additionalProperties":false,"x-mcphost-validated":true},"annotations":null,"definitionHash":"37374208a9ee59f19272bbd692b192ce7674e574d7e145895135633fedeaf479","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T19:47:38.304Z","metadataTrust":"untrusted"},{"serverName":"dev.mcphost/mcphost","endpointFingerprint":"d0a85c5b48c06d69a4304726a2ca9da9d2546be8de456500be18628faebeec33","name":"host.state.list","title":null,"description":"List keys (with their current values) in this tenant's key-value state namespace, optionally filtered by prefix.","inputSchema":{"type":"object","properties":{"end_user":{"description":"\"self\" for the caller's own verified end-user identity, an explicit subject (only when this call carries no end-user identity of its own), or omit/null for the tenant-wide value.","type":["string","null"]},"limit":{"description":"Max keys to return; default 100.","type":"integer"},"prefix":{"description":"Only list keys starting with this prefix; default: all keys.","type":"string"},"tenant_key":{"description":"The key `signup` returned. Optional on the connection that ran signup (or host.redeem): that connection is already bound to the tenant it created, so later calls on it need no tenant_key. On a connection with no Authorization: Bearer header and no prior signup, omitting it implicitly signs that connection up as a brand-new tenant and runs this call as it -- see host.whoami's source field. When both a header and this argument are present, the header wins.","type":"string"}},"required":[],"additionalProperties":false,"x-mcphost-validated":true},"annotations":null,"definitionHash":"f9e55558cee5f44fca75ebe9e290c986f0b7fef79a3983ad52d3bb56e31c6b9f","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T19:47:38.304Z","metadataTrust":"untrusted"},{"serverName":"dev.mcphost/mcphost","endpointFingerprint":"d0a85c5b48c06d69a4304726a2ca9da9d2546be8de456500be18628faebeec33","name":"host.state.set","title":null,"description":"Write one key in this tenant's key-value state namespace; value may be any JSON value. Overrun of the plan's state_bytes_max quota fails with state_quota_exceeded and writes nothing.","inputSchema":{"type":"object","properties":{"dry_run":{"description":"return the diff this call would make and commit nothing","type":"boolean"},"end_user":{"description":"\"self\" for the caller's own verified end-user identity, an explicit subject (only when this call carries no end-user identity of its own), or omit/null for the tenant-wide value.","type":["string","null"]},"key":{"description":"Key to write in this tenant's key-value state namespace.","type":"string"},"tenant_key":{"description":"The key `signup` returned. Optional on the connection that ran signup (or host.redeem): that connection is already bound to the tenant it created, so later calls on it need no tenant_key. On a connection with no Authorization: Bearer header and no prior signup, omitting it implicitly signs that connection up as a brand-new tenant and runs this call as it -- see host.whoami's source field. When both a header and this argument are present, the header wins.","type":"string"},"value":{"description":"Any JSON value to store under key.","type":["string","number","integer","boolean","array","object","null"]}},"required":["key","value"],"additionalProperties":false,"x-mcphost-validated":true},"annotations":null,"definitionHash":"f0aec7b79584088f5b8fa09fcb5fde5756a30e359116702e0ff10a81d104a701","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T19:47:38.304Z","metadataTrust":"untrusted"},{"serverName":"dev.mcphost/mcphost","endpointFingerprint":"d0a85c5b48c06d69a4304726a2ca9da9d2546be8de456500be18628faebeec33","name":"host.tool_call","title":null,"description":"Invoke a tool this tenant has already published, by its local name -- the same real, metered call as calling it directly by its namespaced name (<namespace>.<name>), for a session that has no way to see its own namespaced tool name yet. Unlike host.tool_test, this counts toward host.usage and appears in host.tool_logs. Pass async: true for a tool that needs more than the call deadline: returns {run_id, status: \"queued\"} immediately instead of running inline -- see host.runs.get/wait. Pass version to pin the call to one of host.tool_history's versions instead of whichever is current.","inputSchema":{"type":"object","properties":{"args":{"description":"Arguments to pass, validated against the tool's own args_schema.","type":"object"},"async":{"description":"Run as a job instead of inline: returns {run_id, status} within ~50ms under the plan's job_max_s deadline; default false.","type":"boolean"},"budget":{"description":"Lowers this call's budget below the plan default: any subset of max_child_calls, max_est_tokens, max_tool_latency_ms, max_wall_ms. A value above the plan's own ceiling is a validation error naming it; see host.runs.get's progress.budget.","properties":{"max_child_calls":{"description":"Free-plan ceiling 20; pro ceiling 50. Maximum shown is the free floor -- see host.quickstart limits.plan.budget for your plan.","maximum":20,"minimum":1,"type":"integer"},"max_est_tokens":{"description":"Free-plan ceiling 200000; pro ceiling 2000000. Maximum shown is the free floor -- see host.quickstart limits.plan.budget for your plan.","maximum":200000,"minimum":1,"type":"integer"},"max_tool_latency_ms":{"description":"Free-plan ceiling 30000; pro ceiling 120000. Maximum shown is the free floor -- see host.quickstart limits.plan.budget for your plan.","maximum":30000,"minimum":1,"type":"integer"},"max_wall_ms":{"description":"Free-plan ceiling 60000; pro ceiling 600000. Maximum shown is the free floor -- see host.quickstart limits.plan.budget for your plan.","maximum":60000,"minimum":1,"type":"integer"}},"type":"object"},"dry_run":{"description":"Ask instead of call: runs every admission check the real call runs, dispatches nothing, writes no call row, and returns {fits, units, remaining, refusal}; same as host.estimate. Default false.","type":"boolean"},"name":{"description":"Local name of the tool to invoke.","type":"string"},"tenant_key":{"description":"The key `signup` returned. Optional on the connection that ran signup (or host.redeem): that connection is already bound to the tenant it created, so later calls on it need no tenant_key. On a connection with no Authorization: Bearer header and no prior signup, omitting it implicitly signs that connection up as a brand-new tenant and runs this call as it -- see host.whoami's source field. When both a header and this argument are present, the header wins.","type":"string"},"version":{"description":"Pin the call to this version instead of whichever is current; see host.tool_history. An unknown version is an argument error.","type":"integer"}},"required":["name"],"additionalProperties":false,"x-deprecated":{"replaced_by":"host.tool.call","sunset":"2026-12-31"},"x-mcphost-validated":true},"annotations":null,"definitionHash":"89a1daac0005d531e2fb3e384c5cd1b6c8005dc6936b2e2e5bb1bcb7adf5efde","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T19:47:38.304Z","metadataTrust":"untrusted"},{"serverName":"dev.mcphost/mcphost","endpointFingerprint":"d0a85c5b48c06d69a4304726a2ca9da9d2546be8de456500be18628faebeec33","name":"host.tool_publish","title":null,"description":"Publish a tool of a registered kind (e.g. python, http or echo; the kind argument's enum lists them all) under this tenant's namespace. Call host.quickstart(kind) first for a filled-in example spec and the full publish-to-call sequence. Python's sandbox API: import mcphost (mcphost.table, mcphost.state, mcphost.docs). Name must match ^[a-z][a-z0-9_]{1,40}$; a rejection names the failing field and a corrected example. Try host.tool_test before a real call.","inputSchema":{"type":"object","properties":{"dry_run":{"description":"return the diff this call would make and commit nothing","type":"boolean"},"force":{"description":"Publish a chain whose mapping can never resolve (verdict will_fail) anyway; the response's gates entry then carries forced: true. Default false.","type":"boolean"},"kind":{"description":"Which registered kind to publish under: one of this field's `enum` (host.quickstart with no kind lists every kind, alias and recipe). A job-word alias in the enum also resolves here -- webhook-style words for an inbound webhook, cron-style words for a timed run -- both resolve to kind http and the descriptor comes back with resolved_from naming the alias you asked for. Error contract per kind: chain (families: compose, tool_state, chain_spec; source_line: no); echo (families: none; source_line: no); http (families: upstream, http_call; source_line: no); jq (families: tool_code, tool_limit; source_line: no); js (families: tool_code, tool_limit, upstream, compose, tool_state, js_spec; source_line: yes); python (families: tool_code, tool_limit, upstream, compose, tool_state, python_call; source_line: yes); wasm (families: tool_code, tool_limit; source_line: no).","enum":["chain","echo","http","jq","js","python","wasm","event","events","webhook","webhooks","inbound","trigger","inbox","cron","schedule","scheduled","doc","docs","document","documents","message","messages","msg","database","db","table","tables","csv","sql","schedules","uptime","probe","probes","memory","memories"],"type":"string"},"name":{"description":"Local name for the new tool; must match ^[a-z][a-z0-9_]{1,40}$.","pattern":"^[a-z][a-z0-9_]{1,40}$","type":"string"},"scopes":{"description":"OAuth scopes a token must carry (directly, or via mcp) to reach this tool: catalogued names from host.oauth.scopes, or the built-ins read/write. At most 8. Omit (or [] ) to require only mcp -- unaffected by any catalog.","items":{"type":"string"},"type":"array"},"spec":{"description":"The kind-specific spec object; see host.quickstart(kind) for a filled-in example. For python's network field: \"none\" (every plan), \"public\" (requires the pro plan), \"egress\" (requires the pro plan) -- a tool's own code reaches this tenant's data with `import mcphost` (mcphost.table, mcphost.state, mcphost.docs, mcphost.lineage) even when network is \"none\".","type":"object"},"tags":{"description":"Catalog tags: at most 16, each 1-32 chars of a-z, 0-9 and '-', stored lower-case and deduped.","items":{"type":"string"},"type":"array"},"tenant_key":{"description":"The key `signup` returned. Optional on the connection that ran signup (or host.redeem): that connection is already bound to the tenant it created, so later calls on it need no tenant_key. On a connection with no Authorization: Bearer header and no prior signup, omitting it implicitly signs that connection up as a brand-new tenant and runs this call as it -- see host.whoami's source field. When both a header and this argument are present, the header wins.","type":"string"},"visibility":{"description":"Who may find the tool (default private). unlisted: callable by full name and readable by host.catalog.get, never listed. public: listed in the catalog, and refused (untested_tool_cannot_be_public) unless the current version passes its dry run first. Use host.tool_share for group or url.","enum":["private","unlisted","public"],"type":"string"}},"required":["name","kind","spec"],"additionalProperties":false,"allOf":[{"if":{"properties":{"kind":{"const":"chain"}},"required":["kind"]},"then":{"properties":{"spec":{"additionalProperties":false,"properties":{"description":{"description":"the tool's description in `tools/list` (every kind)"},"outputs":{"description":"fields a caller can rely on in `result.payload`, optionally with a `$.a.b` path each (every kind)"},"reads":{"description":"tables this tool reads, recorded for lineage and blast-radius reports"},"steps":{},"ui":{"additionalProperties":false,"description":"Optional presentation hints. `form: true` gives a url-shared tool a /f/ page where a person fills in the arguments and the submission lands in your inbox.","properties":{"form":{"type":"boolean"},"submit_label":{"maxLength":40,"type":"string"},"success_text":{"maxLength":200,"type":"string"}},"type":"object"}},"required":["steps"],"type":"object"}}}},{"if":{"properties":{"kind":{"const":"echo"}},"required":["kind"]},"then":{"properties":{"spec":{"additionalProperties":false,"properties":{"description":{"description":"the tool's description in `tools/list` (every kind)"},"outputs":{"description":"fields a caller can rely on in `result.payload`, optionally with a `$.a.b` path each (every kind)"},"reads":{"description":"tables this tool reads, recorded for lineage and blast-radius reports"},"schema":{},"ui":{"additionalProperties":false,"description":"Optional presentation hints. `form: true` gives a url-shared tool a /f/ page where a person fills in the arguments and the submission lands in your inbox.","properties":{"form":{"type":"boolean"},"submit_label":{"maxLength":40,"type":"string"},"success_text":{"maxLength":200,"type":"string"}},"type":"object"}},"required":["schema"],"type":"object"}}}},{"if":{"properties":{"kind":{"const":"http"}},"required":["kind"]},"then":{"properties":{"spec":{"additionalProperties":false,"properties":{"args_schema":{},"body":{},"description":{"description":"the tool's description in `tools/list` (every kind)"},"headers":{},"method":{},"outputs":{"description":"fields a caller can rely on in `result.payload`, optionally with a `$.a.b` path each (every kind)"},"query":{},"reads":{"description":"tables this tool reads, recorded for lineage and blast-radius reports"},"response":{},"timeout_s":{},"ui":{"additionalProperties":false,"description":"Optional presentation hints. `form: true` gives a url-shared tool a /f/ page where a person fills in the arguments and the submission lands in your inbox.","properties":{"form":{"type":"boolean"},"submit_label":{"maxLength":40,"type":"string"},"success_text":{"maxLength":200,"type":"string"}},"type":"object"},"upstream":{},"upstream_provider":{},"url":{}},"type":"object"}}}},{"if":{"properties":{"kind":{"const":"jq"}},"required":["kind"]},"then":{"properties":{"spec":{"additionalProperties":false,"properties":{"args_schema":{},"description":{"description":"the tool's description in `tools/list` (every kind)"},"max_output_bytes":{},"outputs":{"description":"fields a caller can rely on in `result.payload`, optionally with a `$.a.b` path each (every kind)"},"program":{},"reads":{"description":"tables this tool reads, recorded for lineage and blast-radius reports"},"timeout_s":{},"ui":{"additionalProperties":false,"description":"Optional presentation hints. `form: true` gives a url-shared tool a /f/ page where a person fills in the arguments and the submission lands in your inbox.","properties":{"form":{"type":"boolean"},"submit_label":{"maxLength":40,"type":"string"},"success_text":{"maxLength":200,"type":"string"}},"type":"object"}},"required":["program"],"type":"object"}}}},{"if":{"properties":{"kind":{"const":"js"}},"required":["kind"]},"then":{"properties":{"spec":{"additionalProperties":false,"properties":{"args_schema":{"description":"a JSON Schema object"},"description":{"description":"a string"},"env":{"description":"a map of name to string value; names must match ^[A-Z][A-Z0-9_]{0,63}$"},"memory_mb":{"description":"a positive integer number of megabytes"},"network":{"description":"\"none\" (every plan), \"public\" (requires the pro plan), \"egress\" (requires the pro plan) -- a tool's own code reaches this tenant's data with `import mcphost` (mcphost.table, mcphost.state, mcphost.docs, mcphost.lineage) even when network is \"none\""},"outputs":{"description":"a list of field names or an object mapping field names to path strings"},"reads":{"description":"tables this tool reads, recorded for lineage and blast-radius reports"},"secrets":{"description":"a list of strings"},"source":{"description":"a string"},"timeout_s":{"description":"a positive integer number of seconds"},"ui":{"additionalProperties":false,"description":"Optional presentation hints. `form: true` gives a url-shared tool a /f/ page where a person fills in the arguments and the submission lands in your inbox.","properties":{"form":{"type":"boolean"},"submit_label":{"maxLength":40,"type":"string"},"success_text":{"maxLength":200,"type":"string"}},"type":"object"}},"required":["source"],"type":"object"}}}},{"if":{"properties":{"kind":{"const":"python"}},"required":["kind"]},"then":{"properties":{"spec":{"additionalProperties":false,"properties":{"args_schema":{"description":"a JSON Schema object"},"description":{"description":"a string"},"env":{"description":"a map of name to string value; names must match ^[A-Z][A-Z0-9_]{0,63}$"},"memory_mb":{"description":"a positive integer number of megabytes"},"network":{"description":"\"none\" (every plan), \"public\" (requires the pro plan), \"egress\" (requires the pro plan) -- a tool's own code reaches this tenant's data with `import mcphost` (mcphost.table, mcphost.state, mcphost.docs, mcphost.lineage) even when network is \"none\""},"outputs":{"description":"a list of field names or an object mapping field names to path strings"},"reads":{"description":"tables this tool reads, recorded for lineage and blast-radius reports"},"requirements":{"description":"a list of strings"},"secrets":{"description":"a list of strings"},"source":{"description":"a string"},"timeout_s":{"description":"a positive integer number of seconds"},"ui":{"additionalProperties":false,"description":"Optional presentation hints. `form: true` gives a url-shared tool a /f/ page where a person fills in the arguments and the submission lands in your inbox.","properties":{"form":{"type":"boolean"},"submit_label":{"maxLength":40,"type":"string"},"success_text":{"maxLength":200,"type":"string"}},"type":"object"}},"required":["source"],"type":"object"}}}},{"if":{"properties":{"kind":{"const":"wasm"}},"required":["kind"]},"then":{"properties":{"spec":{"additionalProperties":false,"properties":{"args_schema":{},"component":{},"description":{"description":"the tool's description in `tools/list` (every kind)"},"memory_mb":{},"outputs":{"description":"fields a caller can rely on in `result.payload`, optionally with a `$.a.b` path each (every kind)"},"reads":{"description":"tables this tool reads, recorded for lineage and blast-radius reports"},"timeout_s":{},"ui":{"additionalProperties":false,"description":"Optional presentation hints. `form: true` gives a url-shared tool a /f/ page where a person fills in the arguments and the submission lands in your inbox.","properties":{"form":{"type":"boolean"},"submit_label":{"maxLength":40,"type":"string"},"success_text":{"maxLength":200,"type":"string"}},"type":"object"}},"required":["component"],"type":"object"}}}}],"x-deprecated":{"replaced_by":"host.tool.publish","sunset":"2026-12-31"}},"annotations":null,"definitionHash":"fae4fe465b66514e41232a17d9ca708409e6e2a2e2610a8f2bad7a2f1830d424","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T19:47:38.304Z","metadataTrust":"untrusted"},{"serverName":"dev.mcphost/mcphost","endpointFingerprint":"d0a85c5b48c06d69a4304726a2ca9da9d2546be8de456500be18628faebeec33","name":"host.tool_share","title":null,"description":"Share one of this tenant's published tools with everyone (visibility: \"public\") or with a named group this tenant owns (visibility: \"group\", group: <name>). The tool keeps running in this tenant's own sandbox with this tenant's own secrets; a caller reaches it as <this tenant's namespace>.<name>.","inputSchema":{"type":"object","properties":{"description":{"description":"Catalog-facing blurb; shown by host.catalog.search/get.","type":"string"},"expose_spec":{"description":"Default false. When true, any tenant this tool is shared with may call host.tool_spec_shared to read its (redacted) spec.","type":"boolean"},"group":{"description":"Required when visibility is \"group\"; must already exist (host.group.create).","type":"string"},"name":{"description":"Local name of the tool to share.","type":"string"},"rate_per_hour_per_caller":{"description":"Optional cap (1..10000) on calls per hour from any one grantee.","maximum":10000,"minimum":1,"type":"integer"},"scopes":{"description":"What the grantee may do: call, read_source, fork. Default [\"call\"] ([\"call\",\"read_source\"] with expose_spec: true). url shares allow only call.","items":{"enum":["call","read_source","fork"],"type":"string"},"minItems":1,"type":"array"},"tags":{"description":"Catalog tags merged into the tool's existing ones (same rules as host.tool_publish).","items":{"type":"string"},"type":"array"},"tenant_key":{"description":"The key `signup` returned. Optional on the connection that ran signup (or host.redeem): that connection is already bound to the tenant it created, so later calls on it need no tenant_key. On a connection with no Authorization: Bearer header and no prior signup, omitting it implicitly signs that connection up as a brand-new tenant and runs this call as it -- see host.whoami's source field. When both a header and this argument are present, the header wins.","type":"string"},"visibility":{"description":"\"public\" (needs a passing dry run of the current version), \"unlisted\", \"group\" or \"url\".","enum":["unlisted","group","org","public","url"],"type":"string"}},"required":["name","visibility"],"additionalProperties":false,"x-deprecated":{"replaced_by":"host.tool.share","sunset":"2026-12-31"},"x-mcphost-validated":true},"annotations":null,"definitionHash":"60d77da6734fa2a39ae6faf4fc704dac7adcc83e698c1021d1ccbdf4270ad3a5","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T19:47:38.304Z","metadataTrust":"untrusted"},{"serverName":"dev.mcphost/mcphost","endpointFingerprint":"d0a85c5b48c06d69a4304726a2ca9da9d2546be8de456500be18628faebeec33","name":"host.tool_test","title":null,"description":"Dry-run a published tool by name: verdict (pass/will_fail/unverifiable), writes rolled back (dry_run); see host.quickstart.","inputSchema":{"type":"object","properties":{"args":{"description":"Arguments to pass, same shape as a real call. Omit to run one example generated from the tool's args_schema; the response then carries example_args (what ran) and untyped (keys the schema gave no type for).","type":"object"},"fixtures":{"description":"Chain tools only: {\"<step number or tool name>\": <recorded result>}. A fixtured step executes nothing (no upstream call); later mappings resolve against it. host.runs.get(run_id, as_fixtures=true) exports a real run in this shape.","type":"object"},"name":{"description":"Local name of the already-published tool to dry-run.","type":"string"},"tenant_key":{"description":"The key `signup` returned. Optional on the connection that ran signup (or host.redeem): that connection is already bound to the tenant it created, so later calls on it need no tenant_key. On a connection with no Authorization: Bearer header and no prior signup, omitting it implicitly signs that connection up as a brand-new tenant and runs this call as it -- see host.whoami's source field. When both a header and this argument are present, the header wins.","type":"string"}},"required":["name"],"additionalProperties":false,"x-deprecated":{"replaced_by":"host.tool.test","sunset":"2026-12-31"},"x-mcphost-validated":true},"annotations":null,"definitionHash":"2eb788c59bbcad2c79dab56ee6c782b3bb3099d829cc247d6bba0c6a1ecbe1c9","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T19:47:38.304Z","metadataTrust":"untrusted"},{"serverName":"dev.mcphost/mcphost","endpointFingerprint":"d0a85c5b48c06d69a4304726a2ca9da9d2546be8de456500be18628faebeec33","name":"host.whoami","title":null,"description":"Return the calling tenant's identity, including key_age_s and key_rotated_at for auditing credential hygiene.","inputSchema":{"type":"object","properties":{"tenant_key":{"description":"The key `signup` returned. Optional on the connection that ran signup (or host.redeem): that connection is already bound to the tenant it created, so later calls on it need no tenant_key. On a connection with no Authorization: Bearer header and no prior signup, omitting it implicitly signs that connection up as a brand-new tenant and runs this call as it -- see host.whoami's source field. When both a header and this argument are present, the header wins.","type":"string"}},"required":[],"additionalProperties":false,"x-mcphost-validated":true},"annotations":null,"definitionHash":"fd2a466c2ef3ddc8b08adc17922e8d691f64c8ca23b86d950268f1c20888f6f7","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T19:47:38.304Z","metadataTrust":"untrusted"},{"serverName":"dev.mcphost/mcphost","endpointFingerprint":"d0a85c5b48c06d69a4304726a2ca9da9d2546be8de456500be18628faebeec33","name":"signup","title":null,"description":"Explicit signup, for a client that cannot keep a session across calls: create a tenant and receive a bearer key and namespace. Unauthenticated. Most clients never need this -- any other host.*/billing.* call from a fresh connection creates a tenant implicitly and returns its own /u/<secret>/mcp URL in the response's onboarding field. Recommended here: pass handoff: true to receive a short-lived, single-use handoff_token instead of the raw key -- redeem it once with host.redeem to get the key, so a transcript of this call and the redeem call, if it leaks, carries a dead credential. The raw-key path (handoff omitted) stays fully supported.","inputSchema":{"type":"object","properties":{"handoff":{"description":"Recommended: true to receive a handoff_token (redeem via host.redeem) instead of the raw key. Default false (raw key, unchanged).","type":"boolean"},"name":{"description":"display name","type":"string"},"source":{"description":"Optional attribution tag for this signup (1-64 chars matching the pattern), e.g. \"plugin\", \"www\", \"cli\", \"hn\"; omit for none. Stored as the tenant's signup_source and counted in the signup-source funnel. Attribution only: whether a signup is real or synthetic is decided by the harness header and fleet IP, never by this value. \"synthorg\" is reserved for the discovery-chain harness.","pattern":"^[a-z0-9][a-z0-9._-]{0,63}$","type":"string"}},"required":["name"],"additionalProperties":false},"annotations":null,"definitionHash":"e6c28556109b59b1051e0239255c8996c59223f1eb6caaddb2aabc36905faae9","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T19:47:38.304Z","metadataTrust":"untrusted"}],"endpoints":[{"endpointFingerprint":"d0a85c5b48c06d69a4304726a2ca9da9d2546be8de456500be18628faebeec33","protocol":"streamable-http","status":"indexed","toolCount":18,"observedAt":"2026-11-17T19:47:38.304Z"}],"authentication":"unknown"},"connectionConfigurations":{"status":"ready","authentication":"not embedded","clients":{"Claude Desktop":{"mcpServers":{"dev.mcphost/mcphost":{"url":"https://mcphost.dev/mcp"}}},"Cursor":{"mcpServers":{"dev.mcphost/mcphost":{"url":"https://mcphost.dev/mcp"}}},"VS Code":{"servers":{"dev.mcphost/mcphost":{"type":"http","url":"https://mcphost.dev/mcp"}}}}},"resourceType":"mcp-server","callable":true,"runtime":{"callable":true,"protocols":["mcp"]},"interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://mcphost.dev/mcp"}],"profile":{"apiVersion":"1","schemaVersion":"1","id":"mcp-server:dev.mcphost%2Fmcphost","resourceType":"mcp-server","canonicalUrl":"https://www.agentsjunction.com/api/v1/servers/dev.mcphost%2Fmcphost","name":"dev.mcphost/mcphost","description":"Hosted MCP runtime where your agent publishes its own tools by tool call and keeps working.","interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://mcphost.dev/mcp"}],"capabilities":[],"identity":{"source":"official-registry","websiteUrl":"https://mcphost.dev","repositoryUrl":"https://github.com/j0yen/mcphost","version":"0.130.19"},"verification":{"state":"official","confidence":100},"operations":{"resourceType":"mcp-server","name":"dev.mcphost/mcphost","status":"online","lastCheckedAt":"2026-11-20T08:18:55.111Z","lastSuccessfulCheck":"2026-11-20T08:18:55.111Z","latencyMs":307,"consecutiveFailures":0,"isStale":false,"checks":{"endpointReachable":true,"protocolValid":true,"agentCardValid":null,"mcpHandshakeValid":true},"lastSeen":null,"lastSuccessfulInteraction":null,"lastHealthCheck":"2026-11-20T08:18:55.111Z","source":{"type":"health-check","url":null},"observedAt":"2026-11-20T08:18:55.111Z"},"security":null,"timestamps":{"createdAt":"2026-11-14T12:24:30.537Z","updatedAt":"2026-11-14T12:24:30.537Z","observedAt":"2026-11-20T08:18:55.111Z"},"compatibility":{"serverVersion":"0.130.19","protocolVersions":[{"protocol":"mcp","version":null}]}}}}