Server definition
- Hash
- sha256:cacf5f00c7f363d5dc52a69efa8d08b65dbc709be0ccbd8e0afe1401eef54ec5
- What it is
- What a remote MCP server returned when asked what it offers: 48 tools
The blob, as servednamed by its sha256
{
"instructions": "ToolRouter serves operation guidance as Agent Skills. Skills-aware hosts can enumerate them with skills/list, retrieve one with skills/get, and load its files on demand with resources/read.",
"tools": [
{
"description": "List all billing contexts (personal + teams) or get detail on one. No slug → summary list. With slug → full detail including team members, role, subscription status, and pointers to the team's connectors, credentials, keys, and files.",
"inputSchema": {
"properties": {
"slug": {
"description": "Account slug for detail view. Omit to list all.",
"type": "string"
}
},
"type": "object"
},
"name": "account_list",
"outputSchema": null
},
{
"description": "Read or write billing preferences (auto-reload, budget cap, default context). Pass action: \"get\" to read, action: \"set\" with fields to write.",
"inputSchema": {
"properties": {
"action": {
"description": "\"get\" to read preferences, \"set\" to update them.",
"enum": [
"get",
"set"
],
"type": "string"
},
"auto_reload_amount": {
"description": "Amount (USD) to reload when triggered (set only, max 500).",
"maximum": 500,
"minimum": 1,
"type": "number"
},
"auto_reload_enabled": {
"description": "Enable or disable auto-reload (set only).",
"type": "boolean"
},
"auto_reload_threshold": {
"description": "Balance threshold (USD) that triggers a reload (set only).",
"minimum": 0,
"type": "number"
},
"budget_limit": {
"description": "Monthly spending cap in USD, or null to remove (set only).",
"minimum": 0,
"type": [
"number",
"null"
]
},
"default_billing_context": {
"description": "Default account to bill (set only). \"personal\" or \"team:<id>\".",
"type": "string"
}
},
"required": [
"action"
],
"type": "object"
},
"name": "account_preferences",
"outputSchema": null
},
{
"description": "Initialize or re-check your account, provision it when needed, and return your user ID and plan. CALL THIS FIRST when the user asks to set up ToolRouter, connect their account, check their account status, or get started.",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "account_setup",
"outputSchema": null
},
{
"description": "Set the active billing context. Accepts a slug (e.g. \"personal\", \"team:nd7fx…\") or team ID.",
"inputSchema": {
"properties": {
"context": {
"description": "Account slug or team ID to switch to (e.g. \"personal\", \"team:nd7fx…\").",
"type": "string"
}
},
"required": [
"context"
],
"type": "object"
},
"name": "account_switch",
"outputSchema": null
},
{
"description": "Create a new brain page. Knowledge you add here will be available to all future tool calls. Optional wing/room/hall organise the page in the MemPalace hierarchy for sharper retrieval.",
"inputSchema": {
"properties": {
"content": {
"description": "Page content (markdown)",
"type": "string"
},
"hall": {
"description": "Optional. One of \"fact\", \"event\", \"discovery\", \"preference\", \"advice\". Defaults to \"fact\".",
"type": "string"
},
"load_tier": {
"description": "Optional. L0 = operator identity (rare), L1 = always-loaded critical fact, L2 = default on-demand, L3 = cold archive. Omit to default to L2.",
"enum": [
"L0",
"L1",
"L2",
"L3"
],
"type": "string"
},
"room": {
"description": "Optional. Sub-area within the wing (e.g. \"databases\", \"deploy\"). Defaults to \"untagged\".",
"type": "string"
},
"scope": {
"description": "Visibility scope. Defaults to personal.",
"enum": [
"personal",
"team"
],
"type": "string"
},
"tags": {
"description": "Tags for categorisation",
"items": {
"type": "string"
},
"type": "array"
},
"title": {
"description": "Page title",
"type": "string"
},
"wing": {
"description": "Optional. Top-level area (e.g. \"engineering\", \"family\", \"general\"). Auto-classified if omitted.",
"type": "string"
}
},
"required": [
"title",
"content"
],
"type": "object"
},
"name": "brain_add",
"outputSchema": null
},
{
"description": "Brain admin operations. Pass action: \"lint\" | \"link\" | \"promote\" | \"rebuild_index\" | \"team_sleep\". team_sleep enables/disables/runs the nightly team consolidation cycle — pass sub_action \"enable\" (with optional timezone), \"disable\", \"status\", or \"run_now\". Team admin role required for team_sleep actions.",
"inputSchema": {
"properties": {
"action": {
"description": "Admin operation to perform.",
"enum": [
"lint",
"link",
"promote",
"rebuild_index",
"team_sleep"
],
"type": "string"
},
"label": {
"description": "Human-readable relationship label (for link).",
"type": "string"
},
"page_id": {
"description": "Source brain page ID (for link/promote).",
"type": "string"
},
"relationship": {
"description": "Relationship type (for link, e.g. relates_to, derived_from).",
"type": "string"
},
"sub_action": {
"description": "Required for action=\"team_sleep\". \"enable\" turns on nightly sleep for the team; \"disable\" turns it off; \"status\" shows last run and schedule; \"run_now\" triggers an immediate sleep cycle.",
"enum": [
"enable",
"disable",
"status",
"run_now"
],
"type": "string"
},
"team_id": {
"description": "Team to promote to (for promote). Auto-resolved if on one team.",
"type": "string"
},
"timezone": {
"description": "IANA timezone for team_sleep enable (e.g. \"Europe/London\"). Defaults to UTC. Sleep fires at 3 AM local time.",
"type": "string"
},
"to_page_id": {
"description": "Target page ID (for link).",
"type": "string"
}
},
"required": [
"action"
],
"type": "object"
},
"name": "brain_admin",
"outputSchema": null
},
{
"description": "Archive a brain page. It will no longer appear in searches or tool consultations.",
"inputSchema": {
"properties": {
"page_id": {
"description": "Brain page ID (bp_...) to archive",
"type": "string"
}
},
"required": [
"page_id"
],
"type": "object"
},
"name": "brain_delete",
"outputSchema": null
},
{
"description": "Retrieve the verbatim source text (a \"drawer\") linked from a brain page. Use this when a summary lacks specifics you need — drawers contain the original tool output, redacted for credentials. Returns 404 if the page has no linked drawer (not all pages do — drawers are a Step 4 feature for allowlisted tools only).",
"inputSchema": {
"properties": {
"page_id": {
"description": "Brain page ID (bp_...) whose drawer to expand.",
"type": "string"
}
},
"required": [
"page_id"
],
"type": "object"
},
"name": "brain_expand",
"outputSchema": null
},
{
"description": "Run maintenance checks on your brain: find stale pages, orphaned knowledge, and other issues.",
"inputSchema": {
"properties": {},
"required": [],
"type": "object"
},
"name": "brain_lint",
"outputSchema": null
},
{
"description": "Search your knowledge brain for relevant information. Returns pages ranked by relevance. Optional wing/hall narrow the search to a slice of the brain (e.g. wing=\"engineering\", hall=\"preference\").",
"inputSchema": {
"properties": {
"as_of": {
"description": "Optional. ISO-date string (e.g. \"2026-01-15\"). When set, returns pages that were valid at that point in time — including superseded versions. Useful for \"what did we know in January?\" queries.",
"type": "string"
},
"hall": {
"description": "Optional. Restrict to a hall: \"fact\", \"event\", \"discovery\", \"preference\", or \"advice\".",
"type": "string"
},
"include_drawer_previews": {
"description": "Optional. When true, each result includes the first ~400 chars of its linked drawer (raw source text) if one exists. Useful to decide whether to call brain_expand for the full text.",
"type": "boolean"
},
"limit": {
"description": "Max results. Defaults to 10.",
"type": "number"
},
"query": {
"description": "Search query. Omit to list all pages by recency.",
"type": "string"
},
"scope": {
"description": "Which brain scope to search. Defaults to all.",
"enum": [
"personal",
"team",
"all"
],
"type": "string"
},
"wing": {
"description": "Optional. Restrict to a specific wing (top-level area like \"engineering\", \"family\").",
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "brain_query",
"outputSchema": null
},
{
"description": "View and toggle your brain settings. Currently supports: drawers_enabled (store raw tool output alongside summaries for richer recall).",
"inputSchema": {
"properties": {
"action": {
"description": "\"get\" lists current settings; \"set\" toggles a named setting.",
"enum": [
"get",
"set"
],
"type": "string"
},
"setting": {
"description": "Setting name (required for \"set\"). Currently: \"drawers_enabled\".",
"type": "string"
},
"value": {
"description": "New value (required for \"set\").",
"type": "boolean"
}
},
"required": [
"action"
],
"type": "object"
},
"name": "brain_settings",
"outputSchema": null
},
{
"description": "View brain page counts and recent pages for your personal and team brain.",
"inputSchema": {
"properties": {},
"required": [],
"type": "object"
},
"name": "brain_status",
"outputSchema": null
},
{
"description": "Edit an existing brain page's content or metadata. wing/room/hall can be patched to re-file a page. scope can be changed to move a page between your personal and team brain — useful when an auto-ingested page landed in the wrong place. Moving a page to team scope requires team admin role.",
"inputSchema": {
"properties": {
"content": {
"description": "New content (replaces existing)",
"type": "string"
},
"hall": {
"description": "Optional. Change hall: fact / event / discovery / preference / advice.",
"type": "string"
},
"load_tier": {
"description": "Optional. Change load tier. L1 promotes a page to always-loaded; L3 sends it to cold archive.",
"enum": [
"L0",
"L1",
"L2",
"L3"
],
"type": "string"
},
"material_change": {
"description": "Optional. When true, creates a new version of the page — the old version is preserved with a timestamp and a \"supersedes\" link. Use for corrections or significant changes; skip for minor edits. Default false.",
"type": "boolean"
},
"page_id": {
"description": "Brain page ID (bp_...)",
"type": "string"
},
"room": {
"description": "Optional. Re-file under a different room.",
"type": "string"
},
"scope": {
"description": "Optional. Move the page between your personal and team brain. Moving TO team requires team admin role and a team billing context. Moving FROM team to personal is allowed if you own the page or are an admin.",
"enum": [
"personal",
"team"
],
"type": "string"
},
"tags": {
"description": "New tags",
"items": {
"type": "string"
},
"type": "array"
},
"title": {
"description": "New title",
"type": "string"
},
"wing": {
"description": "Optional. Re-file under a different wing.",
"type": "string"
}
},
"required": [
"page_id"
],
"type": "object"
},
"name": "brain_update",
"outputSchema": null
},
{
"description": "List the wings of your brain — the top-level areas your knowledge is organised under (e.g. \"engineering\", \"family\"). For each wing returns the rooms and halls inside, page count, and last-updated time. Use this to discover the right wing/hall to pass to brain_query.",
"inputSchema": {
"properties": {
"include_team": {
"description": "If true, also count team-scope pages. Default false (personal only).",
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"name": "brain_wings",
"outputSchema": null
},
{
"description": "Connect a new OAuth account or MCP server. For OAuth: pass type: \"oauth\", kind: \"slack\". For MCP catalog: pass catalog_slug. For custom MCP: pass url + auth_type.",
"inputSchema": {
"properties": {
"auth_token": {
"description": "Auth token or API key.",
"type": "string"
},
"auth_type": {
"description": "Auth type (custom MCP). Default: none.",
"enum": [
"none",
"bearer",
"header_key"
],
"type": "string"
},
"billing": {
"description": "Scope: \"personal\" (default), \"team\" (auto-resolves), a team slug, or \"team:<id>\".",
"type": "string"
},
"catalog_slug": {
"description": "MCP catalog slug for one-click connect.",
"type": "string"
},
"display_name": {
"description": "Human-readable name (custom MCP).",
"type": "string"
},
"header_name": {
"description": "Custom header name (for header_key auth).",
"type": "string"
},
"kind": {
"description": "OAuth connector kind (e.g. \"slack\", \"notion\"). Required for type: \"oauth\".",
"type": "string"
},
"slug": {
"description": "Short identifier for the connection.",
"type": "string"
},
"type": {
"description": "Type of connector to add.",
"enum": [
"oauth",
"mcp"
],
"type": "string"
},
"url": {
"description": "MCP server endpoint URL (custom MCP).",
"type": "string"
}
},
"type": "object"
},
"name": "connector_add",
"outputSchema": null
},
{
"description": "List connected accounts and MCP servers (summary) or detail on one connector. Pass slug for detail including every tool the connector exposes. Optional type: \"oauth\" | \"mcp\" filter. Pass include_available: true to also see available catalog MCPs you can connect.",
"inputSchema": {
"properties": {
"context": {
"description": "Scope: \"personal\" (default) or \"team:<id>\" for a team.",
"type": "string"
},
"include_available": {
"description": "When true, also include catalog MCPs you have not connected yet.",
"type": "boolean"
},
"slug": {
"description": "Connector slug for detail view. Omit to list all.",
"type": "string"
},
"type": {
"description": "Filter by connector type.",
"enum": [
"oauth",
"mcp"
],
"type": "string"
}
},
"type": "object"
},
"name": "connector_list",
"outputSchema": null
},
{
"description": "View or set permissions for tools on a connected MCP server — which tools are allowed, rate limits, budget caps, argument restrictions. Pass the connector slug (from connector_list) and action: \"list\" to see current rules, or action: \"set\" with tool_name + rules to update one. Team scope requires admin role.",
"inputSchema": {
"properties": {
"action": {
"description": "Omit to list permissions for all tools. Pass \"set\" with tool_name + rules to update one.",
"enum": [
"list",
"set"
],
"type": "string"
},
"allowed": {
"description": "Whether the tool is allowed (for set).",
"type": "boolean"
},
"arg_natural_language_rules": {
"description": "Plain English rules for argument filtering (for set). Example: \"Only allow queries for the last 90 days.\"",
"type": "string"
},
"arg_schema_rules": {
"description": "JSON Schema validating tool arguments (for set). Example: {\"properties\":{\"channel\":{\"enum\":[\"#general\"]}}}",
"type": "string"
},
"billing": {
"description": "Scope: \"personal\", \"team\" (auto-resolves if on one team), a team slug, or \"team:<id>\".",
"type": "string"
},
"budget_per_day": {
"description": "Max daily spend per user, in millicents (for set).",
"type": "number"
},
"cost_per_call": {
"description": "Cost in millicents per call (for set).",
"type": "number"
},
"nl_filter_mode": {
"description": "How to enforce NL rules: strict (block on violation) or advisory (log only). Default: strict.",
"enum": [
"strict",
"advisory"
],
"type": "string"
},
"rate_limit_per_day": {
"description": "Max calls per day, per user (for set).",
"type": "number"
},
"rate_limit_per_hour": {
"description": "Max calls per hour, per user (for set).",
"type": "number"
},
"slug": {
"description": "Connector slug.",
"type": "string"
},
"team_budget_per_day": {
"description": "Max daily spend team-wide, in millicents (for set).",
"type": "number"
},
"team_rate_limit_per_day": {
"description": "Max calls per day, team-wide (for set).",
"type": "number"
},
"team_rate_limit_per_hour": {
"description": "Max calls per hour, team-wide (for set).",
"type": "number"
},
"tool_name": {
"description": "Tool name (for set). Use \"*\" for all tools on this connector.",
"type": "string"
}
},
"required": [
"slug"
],
"type": "object"
},
"name": "connector_permissions",
"outputSchema": null
},
{
"description": "Disconnect a connector. Pass slug.",
"inputSchema": {
"properties": {
"billing": {
"description": "Scope: \"personal\" (default), \"team\" (auto-resolves), a team slug, or \"team:<id>\".",
"type": "string"
},
"slug": {
"description": "Connector slug to disconnect.",
"type": "string"
},
"type": {
"description": "Type of connector (mcp or oauth). Default: mcp.",
"enum": [
"oauth",
"mcp"
],
"type": "string"
}
},
"required": [
"slug"
],
"type": "object"
},
"name": "connector_remove",
"outputSchema": null
},
{
"description": "Set the default value for a multi-value credential.",
"inputSchema": {
"properties": {
"context": {
"description": "\"personal\" or \"team:<id>\". Defaults to personal.",
"type": "string"
},
"label": {
"description": "Label of the entry to make default (e.g. \"Production\").",
"type": "string"
},
"name": {
"description": "Credential name (e.g. \"ios_app_id\").",
"type": "string"
}
},
"required": [
"name",
"label"
],
"type": "object"
},
"name": "credential_default",
"outputSchema": null
},
{
"description": "Remove a saved credential. If label is provided, removes only that specific entry. If no label, removes ALL entries for that credential name.",
"inputSchema": {
"properties": {
"context": {
"description": "\"personal\" or \"team:<id>\". Defaults to personal.",
"type": "string"
},
"label": {
"description": "Label of the specific entry to delete. Omit to remove all entries for this credential name.",
"type": "string"
},
"name": {
"description": "Credential name to delete (e.g. \"ios_app_id\").",
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
},
"name": "credential_delete",
"outputSchema": null
},
{
"description": "Get setup instructions for a specific credential.",
"inputSchema": {
"properties": {
"name": {
"description": "Credential name (e.g. \"ios_app_id\", \"play_store_app_id\", \"domain\").",
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
},
"name": "credential_guide",
"outputSchema": null
},
{
"description": "List saved credentials (summary) or detail on one. Pass name for detail view. Pass show_available: true to include the full credential catalog.",
"inputSchema": {
"properties": {
"context": {
"description": "\"personal\" or \"team:<id>\". Defaults to personal.",
"type": "string"
},
"name": {
"description": "Credential name for detail view. Omit to list all saved.",
"type": "string"
},
"show_available": {
"description": "Include the full catalogue of available BYOK options. Default false.",
"type": "boolean"
}
},
"type": "object"
},
"name": "credential_list",
"outputSchema": null
},
{
"description": "Save a credential (BYOK provider API key). Saved keys persist across sessions and are used automatically.",
"inputSchema": {
"properties": {
"context": {
"description": "\"personal\" or \"team:<id>\". Defaults to personal.",
"type": "string"
},
"is_default": {
"description": "Set this value as the default for this credential.",
"type": "boolean"
},
"label": {
"description": "Human-readable label to identify this value (e.g. \"MyApp\", \"Staging\"). Required when saving multiple values for the same credential.",
"type": "string"
},
"name": {
"description": "Credential name from the tool requirements (e.g. \"ios_app_id\", \"openai\").",
"type": "string"
},
"value": {
"description": "The credential value to save.",
"type": "string"
}
},
"required": [
"name",
"value"
],
"type": "object"
},
"name": "credential_save",
"outputSchema": null
},
{
"description": "Current balance, plan tier, rate limits, and any negative-balance warnings for the active context.",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "credits_balance",
"outputSchema": null
},
{
"description": "Usage summary or history. Pass scope: \"me\" | \"team\" and detail: \"tool\" | \"skill\". Sorted by cost with _others rollup.",
"inputSchema": {
"properties": {
"detail": {
"default": "tool",
"description": "Detail level. \"tool\" groups by tool, \"skill\" adds per-skill breakdown.",
"enum": [
"tool",
"skill"
],
"type": "string"
},
"limit": {
"description": "Number of top tools/skills to return. Remaining rolled into \"_others\". Default 10.",
"maximum": 500,
"minimum": 0,
"type": "number"
},
"offset": {
"description": "Records to skip for pagination (history mode). Default 0.",
"minimum": 0,
"type": "number"
},
"period": {
"default": "all",
"description": "Time period to summarize. 'all' covers the last 30 days (the maximum window).",
"enum": [
"day",
"week",
"month",
"all"
],
"type": "string"
},
"scope": {
"description": "Whose usage to show. \"me\" for personal, \"team\" for team-wide.",
"enum": [
"me",
"team"
],
"type": "string"
}
},
"type": "object"
},
"name": "credits_usage",
"outputSchema": null
},
{
"description": "Find the right ToolRouter tool for your task. Describe what you need in plain language.\nExamples: \"analyze a website\", \"research competitors\", \"find prospect companies\", \"check DNS records\".\nExact tool name (e.g. \"seo\") returns full schemas and examples.\nFlow: prefer route({ intent }) to pick and run a tool. Use discover when you need schemas or a listing, then call use_tool(tool, skill, input).\nEvery discover response also includes a top-level `connectors` array listing SaaS accounts the user has already connected (LinkedIn, Google, Notion, etc.). Use that to pick the right tool and account without asking — e.g. if `connectors` shows LinkedIn, the linkedin-post tool is ready to use.\nCategories: data, media, search, marketing, development, communication, analytics, productivity, ai, finance, security, infrastructure",
"inputSchema": {
"properties": {
"category": {
"description": "Filter by category",
"enum": [
"data",
"media",
"search",
"marketing",
"development",
"communication",
"analytics",
"productivity",
"ai",
"finance",
"security",
"infrastructure"
],
"type": "string"
},
"query": {
"description": "What you want to do (e.g. \"scrape a webpage\"), a category (e.g. \"security\"), or \"*\" to list everything.",
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "discover",
"outputSchema": null
},
{
"description": "Report a ToolRouter platform bug that blocks you from completing the user's task. Use this when you suspect the issue is on our side — a tool crashed, returned malformed data, timed out unexpectedly, or behaved inconsistently. Include the relevant ToolRouter errors, call IDs, non-sensitive input shape, retries, and expected behavior. Do not include chat history, unrelated conversation text, uploaded file contents, personal data, API keys, or secrets. Reports are stored and reviewed within hours. Skip this for expected errors like invalid input, missing credentials, insufficient balance, rate limits, or genuine \"not found\" results — those aren't bugs. Limit: 5 reports per hour.",
"inputSchema": {
"properties": {
"agent_context": {
"description": "MCP client name and version, if known.",
"type": "string"
},
"call_ids": {
"description": "ALL call IDs from this interaction (successful and failed), one per line or comma-separated.",
"type": "string"
},
"error_messages": {
"description": "ALL error messages received during this interaction — not just the last one. Include the full text of every error response from ToolRouter, separated by newlines.",
"type": "string"
},
"expected_behavior": {
"description": "What you expected to happen vs what actually happened.",
"type": "string"
},
"input_summary": {
"description": "Summary of what you sent to the failing tool (do NOT include API keys or secrets — describe the shape and intent).",
"type": "string"
},
"interaction_log": {
"description": "Chronological log limited to the relevant ToolRouter calls: tool/skill names, non-sensitive input shape, response status, errors, retries, and job polling. Do not include chat history, unrelated conversation text, uploaded file contents, personal data, API keys, or secrets.",
"type": "string"
},
"job_id": {
"description": "Job ID for async jobs that failed, if applicable.",
"type": "string"
},
"severity": {
"description": "\"blocking\" = cannot complete task. \"degraded\" = partial results or workaround exists.",
"enum": [
"blocking",
"degraded"
],
"type": "string"
},
"skill": {
"description": "Skill name that failed (e.g. \"search\").",
"type": "string"
},
"tool": {
"description": "Tool name that failed (e.g. \"web-search\").",
"type": "string"
}
},
"required": [
"error_messages",
"severity"
],
"type": "object"
},
"name": "feedback_debug",
"outputSchema": null
},
{
"description": "Ask ToolRouter to build a tool that does not exist yet. Use this when discover returned nothing useful for what the user needs. Describe the capability in plain terms — do not include personal data, API keys, or secrets. Requests go straight to the team. Limit: 5 per hour.",
"inputSchema": {
"properties": {
"agent_context": {
"description": "MCP client name and version, if known.",
"type": "string"
},
"searched": {
"description": "The discover query you tried that came back empty.",
"type": "string"
},
"what": {
"description": "What the tool should do, in one or two sentences (e.g. \"Look up UK company filings by company number\").",
"type": "string"
},
"why": {
"description": "What the user was trying to accomplish and why existing tools did not fit.",
"type": "string"
}
},
"required": [
"what"
],
"type": "object"
},
"name": "feedback_request_tool",
"outputSchema": null
},
{
"description": "Submit a review or star rating.",
"inputSchema": {
"properties": {
"rating": {
"description": "Star rating 1-5 (1=poor, 3=okay, 5=excellent).",
"maximum": 5,
"minimum": 1,
"type": "number"
},
"review": {
"description": "Constructive feedback — what worked well and any specific suggestions to improve.",
"type": "string"
},
"tool": {
"description": "Tool name to review (e.g. \"web-search\" or \"seo\").",
"type": "string"
}
},
"required": [
"tool",
"rating"
],
"type": "object"
},
"name": "feedback_review",
"outputSchema": null
},
{
"description": "Delete a file. Cannot be undone. For team files: requires owner/admin role.",
"inputSchema": {
"properties": {
"file_id": {
"description": "The file ID to delete.",
"type": "string"
}
},
"required": [
"file_id"
],
"type": "object"
},
"name": "file_delete",
"outputSchema": null
},
{
"description": "List or search files. Optional query triggers semantic search. Supports section, tags, plan_status, limit, cursor filters.",
"inputSchema": {
"properties": {
"context": {
"description": "\"personal\" (default) or \"team:<id>\".",
"type": "string"
},
"cursor": {
"description": "Pagination cursor from a previous file_list response.",
"type": "string"
},
"limit": {
"default": 20,
"description": "Max results (default 20, max 50).",
"type": "number"
},
"plan_status": {
"description": "Filter plans by status.",
"enum": [
"draft",
"active",
"completed",
"archived"
],
"type": "string"
},
"prompt_type": {
"description": "Filter prompts by type (only valid when section is \"prompts\").",
"enum": [
"system",
"user",
"example",
"template",
"script"
],
"type": "string"
},
"query": {
"description": "Natural language search query. Omit to browse.",
"type": "string"
},
"section": {
"description": "Filter by section. Omit to list all.",
"enum": [
"personas",
"plans",
"style_references",
"assets",
"products",
"outfits",
"scenes",
"prompts",
"storyboards"
],
"type": "string"
},
"tags": {
"description": "Filter to files matching ALL of these tags.",
"items": {
"type": "string"
},
"type": "array"
}
},
"type": "object"
},
"name": "file_list",
"outputSchema": null
},
{
"description": "Read a file's full content. Text files return content inline. Binary files (images, video) return a download URL.",
"inputSchema": {
"properties": {
"file_id": {
"description": "The file ID (e.g. \"ast_a1b2c3d4e5f67890\").",
"type": "string"
}
},
"required": [
"file_id"
],
"type": "object"
},
"name": "file_read",
"outputSchema": null
},
{
"description": "Create or update a file. Pass mode: \"create\" | \"update\". Binary uploads: call with binary: true to get an upload_url, then PUT bytes, then call with mode: \"finalize\".",
"inputSchema": {
"properties": {
"asset_id": {
"description": "Existing asset ID to retrieve URL without re-uploading.",
"type": "string"
},
"content": {
"description": "Text content (for .md files).",
"type": "string"
},
"content_type": {
"description": "MIME type. Defaults to \"text/markdown\" for content, \"image/png\" for file_data.",
"type": "string"
},
"context": {
"description": "\"personal\" (default) or \"team:<id>\".",
"type": "string"
},
"description": {
"description": "Optional summary (max 500 chars).",
"type": "string"
},
"file_data": {
"description": "Base64-encoded binary data (for images, video).",
"type": "string"
},
"file_id": {
"description": "File ID to update (required for update/finalize).",
"type": "string"
},
"filename": {
"description": "Optional filename for the asset.",
"type": "string"
},
"image_data": {
"description": "Base64-encoded image. Alternative to image_url when the bytes are already local.",
"type": "string"
},
"image_url": {
"description": "Public URL to download and host permanently.",
"type": "string"
},
"mode": {
"description": "\"create\" for new files, \"update\" to edit existing, \"finalize\" to complete a binary upload.",
"enum": [
"create",
"update",
"finalize"
],
"type": "string"
},
"name": {
"description": "File name (required for create, max 200 chars).",
"type": "string"
},
"plan_status": {
"description": "Plan status (only for plans section).",
"enum": [
"draft",
"active",
"completed",
"archived"
],
"type": "string"
},
"prompt_meta": {
"description": "Prompt metadata (only for prompts section).",
"properties": {
"type": {
"enum": [
"system",
"user",
"example",
"template",
"script"
],
"type": "string"
}
},
"type": "object"
},
"section": {
"description": "Which section to file under (required for create).",
"enum": [
"personas",
"plans",
"style_references",
"assets",
"products",
"outfits",
"scenes",
"prompts",
"storyboards"
],
"type": "string"
},
"tags": {
"description": "Tags for organization (max 10).",
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"mode"
],
"type": "object"
},
"name": "file_write",
"outputSchema": null
},
{
"description": "List invoices for the active billing context.",
"inputSchema": {
"properties": {
"limit": {
"description": "Number of invoices to return (default 10, max 20).",
"maximum": 20,
"minimum": 1,
"type": "number"
}
},
"type": "object"
},
"name": "invoice_list",
"outputSchema": null
},
{
"description": "Cancel a running job.",
"inputSchema": {
"properties": {
"job_id": {
"description": "The job ID to cancel.",
"type": "string"
}
},
"required": [
"job_id"
],
"type": "object"
},
"name": "job_cancel",
"outputSchema": null
},
{
"description": "Get job status and result. Returns status: running | completed | failed and result when terminal. Keep polling until you get a terminal status.",
"inputSchema": {
"properties": {
"job_id": {
"description": "The job ID returned when a long-running tool was called.",
"type": "string"
}
},
"required": [
"job_id"
],
"type": "object"
},
"name": "job_get",
"outputSchema": null
},
{
"description": "List your active and recent jobs. Optional status filter.",
"inputSchema": {
"properties": {
"limit": {
"description": "Max jobs to return (default 20, max 100).",
"maximum": 100,
"minimum": 1,
"type": "number"
},
"status": {
"description": "Filter by job status.",
"enum": [
"pending",
"running",
"completed",
"failed",
"cancelled"
],
"type": "string"
}
},
"type": "object"
},
"name": "job_list",
"outputSchema": null
},
{
"description": "Create a new API key. Returns the secret once — save it immediately.",
"inputSchema": {
"properties": {
"name": {
"description": "A name to identify this key (e.g. \"Claude Desktop\", \"Production Bot\").",
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
},
"name": "key_create",
"outputSchema": null
},
{
"description": "Revoke an API key. Refuses to revoke the currently-authenticating key.",
"inputSchema": {
"properties": {
"key_id": {
"description": "The key ID to revoke (from key_list).",
"type": "string"
}
},
"required": [
"key_id"
],
"type": "object"
},
"name": "key_delete",
"outputSchema": null
},
{
"description": "List API keys (summary) or get detail on one key. Pass key_id for detail view.",
"inputSchema": {
"properties": {
"key_id": {
"description": "Key ID for detail view. Omit to list all.",
"type": "string"
}
},
"type": "object"
},
"name": "key_list",
"outputSchema": null
},
{
"description": "List your outfits.",
"inputSchema": {
"properties": {
"context": {
"description": "\"personal\" (default) or \"team:<id>\".",
"type": "string"
}
},
"type": "object"
},
"name": "outfit_list",
"outputSchema": null
},
{
"description": "List your personas.",
"inputSchema": {
"properties": {
"context": {
"description": "\"personal\" (default) or \"team:<id>\".",
"type": "string"
}
},
"type": "object"
},
"name": "persona_list",
"outputSchema": null
},
{
"description": "List your products.",
"inputSchema": {
"properties": {
"context": {
"description": "\"personal\" (default) or \"team:<id>\".",
"type": "string"
}
},
"type": "object"
},
"name": "product_list",
"outputSchema": null
},
{
"description": "Send a natural-language intent and optionally any dimensions you already know (tool, skill, model, input fields). Fills only the blanks via Jev, then either executes the call or returns a ready-to-run use_tool payload. Explicit values are never overridden. Returns candidates when confidence is low or no tool fits. Flow: route → if confident and complete, result is returned; otherwise use the pre-filled call with use_tool.",
"inputSchema": {
"properties": {
"input": {
"description": "Optional. Partial skill input — explicit fields are never overridden.",
"type": "object"
},
"intent": {
"description": "What you want to do, in plain language.",
"type": "string"
},
"max_cost": {
"description": "Optional. Max USD to spend; above this returns a pre-filled call instead of executing.",
"type": "number"
},
"model": {
"description": "Optional. Model override — honoured verbatim when set.",
"type": "string"
},
"skill": {
"description": "Optional. Skill name — honoured verbatim when set.",
"type": "string"
},
"tool": {
"description": "Optional. Tool name — honoured verbatim when set.",
"type": "string"
}
},
"required": [
"intent"
],
"type": "object"
},
"name": "route",
"outputSchema": null
},
{
"description": "List your scenes.",
"inputSchema": {
"properties": {
"context": {
"description": "\"personal\" (default) or \"team:<id>\".",
"type": "string"
}
},
"type": "object"
},
"name": "scene_list",
"outputSchema": null
},
{
"description": "Get a Stripe management URL (portal, upgrade, or cancel). Also covers billing portal — returns the URL for the user to open.",
"inputSchema": {
"properties": {
"action": {
"description": "\"subscribe\" to start a subscription, \"manage\" to view/cancel existing subscription.",
"enum": [
"subscribe",
"manage"
],
"type": "string"
},
"tier": {
"description": "Which plan to subscribe to (required for \"subscribe\" action).",
"enum": [
"lite",
"plus"
],
"type": "string"
}
},
"required": [
"action"
],
"type": "object"
},
"name": "subscription_manage",
"outputSchema": null
},
{
"description": "Add credits to your account. Returns a Stripe checkout URL — share it with the user to complete payment. Minimum $1.",
"inputSchema": {
"properties": {
"amount_usd": {
"description": "Amount in USD to add (e.g. 10, 25, 50). Minimum $1.",
"maximum": 500,
"minimum": 1,
"type": "number"
}
},
"required": [
"amount_usd"
],
"type": "object"
},
"name": "top_up_credits",
"outputSchema": null
},
{
"description": "Call a ToolRouter catalogue tool. Prefer `route` with a natural-language intent when you do not already know the tool and skill — it picks them, fills arguments, and runs the call. Use discover when you need schemas or a catalogue listing, then pass the exact tool name and skill here. IMPORTANT: \"discover\", \"route\", \"credits_balance\", and other built-in tools are NOT catalogue tools — call them directly, never through use_tool. Long-running tools return a job_id — poll with job_get. If a skill needs an image_url or file URL and you have a local file or base64 image, use file_write first to get a hosted URL, then pass that URL to the skill. BRAIN: Some tools require you to consult brain_query first. If use_tool returns an error about brain_context, call brain_query with a relevant query, then pass the result text as brain_context in your use_tool input.",
"inputSchema": {
"properties": {
"backend": {
"additionalProperties": false,
"description": "Route the same model through interchangeable providers. order prioritises providers; only restricts; ignore excludes; allow_fallbacks defaults true.",
"properties": {
"allow_fallbacks": {
"description": "Try the next provider after an outage, timeout, or rate limit. Defaults to true.",
"type": "boolean"
},
"ignore": {
"description": "Exclude these providers.",
"items": {
"type": "string"
},
"type": "array"
},
"only": {
"description": "Restrict the call to these providers.",
"items": {
"type": "string"
},
"type": "array"
},
"order": {
"description": "Provider slugs to try first, in order.",
"items": {
"type": "string"
},
"type": "array"
}
},
"type": "object"
},
"billing": {
"description": "Which account to bill. \"personal\", \"team\" (auto-resolves if on one team), a team slug (\"humanleap\"), or a team ID (\"team:m57df8c...\"). Omit to use your default.",
"type": "string"
},
"brain_context": {
"description": "Brain knowledge from brain_query. Pass at the top level of use_tool (alongside \"tool\", \"skill\", \"input\") — NOT inside input. Call brain_query first, then paste the result text here to clear the brain gate.",
"type": "string"
},
"input": {
"description": "Skill input parameters (see discover for schema). For persona-using tools, include persona_file_id from discover or persona_list. For scene-using tools, include scene_file_id from discover or scene_list. For product-using tools, include product_file_id from discover or product_list. For outfit-using tools, include outfit_file_id from discover or outfit_list. For style-reference tools, include style_reference_id (from discover or file_list), style_reference_query (semantic search), or style_reference_prompt (inline prose). For image-composition tools (e.g. generate-image image_to_image), pass any combination of scene_file_id, persona_file_id, product_file_ids[] (from file_list section \"products\"), outfit_file_ids[] (section \"outfits\"), and raw image_urls[] — the gateway resolves and merges them into a single image_urls array (max 4 by default).",
"type": "object"
},
"response_format": {
"default": "concise",
"description": "Response verbosity. \"concise\" (default) strips noise, returns essential data only. \"detailed\" returns everything including raw metadata.",
"enum": [
"concise",
"detailed"
],
"type": "string"
},
"skill": {
"description": "Skill name from discover results, e.g. \"search\"",
"type": "string"
},
"tool": {
"description": "Tool reference from discover results, e.g. \"web-search\"",
"type": "string"
}
},
"required": [
"tool",
"skill",
"input"
],
"type": "object"
},
"name": "use_tool",
"outputSchema": null
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:cacf5f00c7f363d5dc52a69efa8d08b65dbc709be0ccbd8e0afe1401eef54ec5 | sha256sum