Hosted MCP runtime where your agent publishes its own tools by tool call and keeps working.
| Endpoint | https://mcphost.dev/mcp (streamable-http) |
|---|---|
| Registry version | 0.130.0 |
| Now | 18 tools · grade F (0) · pin ts_0728c81482d02b924ba914171908192b · protocol 2025-06-18 |
| First / last listed | 2026-11-11 02:13 UTC / 2026-11-11 02:13 UTC |
| Grade over time | 2026-11-11: F (0), 18 tools |
Is this your server? Own a server? ToolFit hosted watch re-checks it every 24 h ($0.25 per 30 days) or 6 h ($0.60) and sends you an HMAC-signed webhook when its tools or grade change: POST https://api.youraitools.co/toolfit/v1/watch. To opt out, see About & opt-out.
Tools: signup host.quickstart host.help.search host.help.get host.errors host.redeem billing.plans host.whoami host.tool_publish host.tool_call host.tool_test host.state.set host.state.get host.state.list host.tool_share host.feedback.send host.feedback.list host.resume
signup | 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, s params: handoff, name*, source |
host.quickstart | 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 g params: kind, retry_after_s, tenant_key |
host.help.search | 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. params: k, kind, q*, tenant_key |
host.help.get | 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. params: anchor*, tenant_key |
host.errors | 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. params: code, tenant_key |
host.redeem | 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. params: handoff_token*, tenant_key |
billing.plans | 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. params: tenant_key |
host.whoami | Return the calling tenant's identity, including key_age_s and key_rotated_at for auditing credential hygiene. params: tenant_key |
host.tool_publish | 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 params: dry_run, force, kind*, name*, scopes, spec*, tags, tenant_key, visibility |
host.tool_call | 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 {ru params: args, async, budget, dry_run, name*, tenant_key, version |
host.tool_test | Dry-run a published tool by name: verdict (pass/will_fail/unverifiable), writes rolled back (dry_run); see host.quickstart. params: args, fixtures, name*, tenant_key |
host.state.set | 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. params: dry_run, end_user, key*, tenant_key, value* |
host.state.get | Read one key from this tenant's key-value state namespace. Returns found: false (not an error) if the key was never set. params: end_user, key*, tenant_key |
host.state.list | List keys (with their current values) in this tenant's key-value state namespace, optionally filtered by prefix. params: end_user, limit, prefix, tenant_key |
host.tool_share | 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>. params: description, expose_spec, group, name*, rate_per_hour_per_caller, scopes, tags, tenant_key, visibility* |
host.feedback.send | Tell the host's humans what you needed: kind, up to 2048 bytes of text, optional context. Works before signup. Returns feedback_id. params: context, kind*, tenant_key, text* |
host.feedback.list | List your own feedback (newest first, status received). Anonymous callers get []. params: limit, tenant_key |
host.resume | 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 c params: tenant_key |
Entries describe changes in tool definitions. They are not statements about a server, its quality or its author. The grade measures how the tool definitions fit model providers (token cost, schema compatibility, confusable names) as scored by the ToolFit engine at the time of the listing. JSON: append .json. Opt-out: how or hello@youraitools.co.