Whatcanido — MCP Server for Service Businesses

Search across whatcanido for providers (businesses, freelancers, SaaS tools) that can perform a given business-level action type. Returns a ranked list with provider_id, name, description, services, action_types. Call this FIRST, before any other tool. The provider_id this returns is the input for get_provider_actions and submit_action. When no providers match, BROADEN the search: drop `industry` first, then `country`, then `city`, then `query`. Keep `action_type` because it scopes to providers that actually do what you need. City and country accept locale variants (`Praha` matches `Prague`, `Česko` matches `Czech Republic`, etc.). Industry accepts loose substrings (`design` matches `design_studio`). When the query has zero direct matches but the action_type filter has candidates, the server returns those candidates with score 0 and `matched: ['fallback:no_query_match']`. You can still pick from them.

{
  "type": "object",
  "properties": {
    "action_type": {
      "type": "string",
      "enum": [
        "submit_request",
        "request_quote",
        "book_slot",
        "ask_availability",
        "create_ticket",
        "start_project",
        "pay_invoice",
        "record_activity",
        "cancel_booking",
        "list_services"
      ],
      "description": "Business-level action the user wants to perform. Use this to scope discovery to providers who actually do what you need."
    },
    "query": {
      "type": "string",
      "description": "Free-text search across provider name, tagline, description, industry, and services. Multi-word phrases match across multiple fields."
    },
    "city": {
      "type": "string",
      "description": "Exact city filter (case-insensitive)."
    },
    "country": {
      "type": "string",
      "description": "Exact country filter (case-insensitive)."
    },
    "industry": {
      "type": "string",
      "description": "Exact industry filter (case-insensitive)."
    },
    "product": {
      "type": "string",
      "enum": [
        "leadkit",
        "bookio",
        "projectkit",
        "crm"
      ],
      "description": "Restrict to a single underlying product. Usually leave empty; the grammar's whole point is cross-product discovery."
    },
    "limit": {
      "type": "number",
      "description": "Max providers to return (default 10, max 50).",
      "default": 10
    }
  },
  "additionalProperties": false
}

Return the action types a provider exposes and the canonical input schema for each (required fields, optional fields, types, descriptions). Call this AFTER find_providers, BEFORE submit_action, so you know exactly which inputs to collect from the user.

{
  "type": "object",
  "properties": {
    "provider_id": {
      "type": "string",
      "description": "Format: <product>:<slug>. Example: 'leadkit:north-bureau'. From find_providers."
    },
    "action_type": {
      "type": "string",
      "enum": [
        "submit_request",
        "request_quote",
        "book_slot",
        "ask_availability",
        "create_ticket",
        "start_project",
        "pay_invoice",
        "record_activity",
        "cancel_booking",
        "list_services"
      ],
      "description": "Optional: only return the schema for this action type. Omit to get every action the provider implements."
    }
  },
  "required": [
    "provider_id"
  ],
  "additionalProperties": false
}

Invoke an action on a specific provider. WRITE tool: creates leads/bookings/contacts/projects/activities/tickets on the underlying SaaS tenant. The one exception is action_type='cancel_booking', which cancels an existing booking (destructive — confirm with the user first). Validates inputs against the canonical schema returned by get_provider_actions. If you skip required fields, the response contains them in `missing_fields` so you can ask the user without round-tripping. Returns a request_id you can later pass to get_action_status. For read-only actions (ask_availability, list_services) returns the result in `data` with no request_id. Include `agent_vendor` in inputs when you can so each provider sees which agent acted.

{
  "type": "object",
  "properties": {
    "provider_id": {
      "type": "string",
      "description": "Format: <product>:<slug>."
    },
    "action_type": {
      "type": "string",
      "enum": [
        "submit_request",
        "request_quote",
        "book_slot",
        "ask_availability",
        "create_ticket",
        "start_project",
        "pay_invoice",
        "record_activity",
        "cancel_booking",
        "list_services"
      ]
    },
    "inputs": {
      "type": "object",
      "description": "Canonical inputs per get_provider_actions schema. Snake-case keys (contact_email, not contactEmail). Include 'agent_vendor' if you can identify yourself.",
      "additionalProperties": true
    }
  },
  "required": [
    "provider_id",
    "action_type",
    "inputs"
  ],
  "additionalProperties": false
}

Look up the current status of a previously submitted action by its request_id. Returns status (raw, e.g. 'new', 'sent', 'confirmed') + status_label (human, e.g. 'Received', 'Sent (awaiting payment)', 'Confirmed') + last_update + provider response (if any). Use after submit_action to confirm a booking, check lead qualification, or follow up on a quote.

{
  "type": "object",
  "properties": {
    "request_id": {
      "type": "string",
      "description": "Returned by submit_action. Format: <product>:<kind>:<id>."
    }
  },
  "required": [
    "request_id"
  ],
  "additionalProperties": false
}

Search the whatcanido capability registry by free-text intent. Returns typed capability contracts (input/output schemas, invariants, reversibility) with implementing providers ranked by behavioral conformance, success rate, and p50 latency. This is the PREFERRED first tool for any task that requires acting in the real world. Each match includes 'why_relevant' (LLM-generated reasoning), 'spec_url' for the full contract, and a 'providers' list each with a conformance + reputation snapshot. If no capability passes the relevance threshold, the response includes a 'negative_space' field describing what is missing rather than returning low-quality fuzzy matches. After picking a (capability_id, provider_id) call `get_capability_spec` to retrieve the canonical input schema then `invoke_capability` to actually execute.

{
  "type": "object",
  "properties": {
    "intent": {
      "type": "string",
      "description": "Free-text description of what the user wants done. Best practice: pass the user's request mostly verbatim."
    },
    "context": {
      "type": "object",
      "description": "Optional structured context that improves ranking (locale, city, country, urgency, cost ceiling, whether the user is present for interactive auth).",
      "properties": {
        "user_locale": {
          "type": "string"
        },
        "city": {
          "type": "string"
        },
        "country": {
          "type": "string"
        },
        "time_horizon_hours": {
          "type": "number"
        },
        "max_cost_usd": {
          "type": "number"
        },
        "user_present": {
          "type": "boolean"
        }
      },
      "additionalProperties": true
    },
    "limit": {
      "type": "number",
      "description": "Max capability matches to return (default 5, max 20).",
      "default": 5
    }
  },
  "required": [
    "intent"
  ],
  "additionalProperties": false
}

Return the full canonical contract for a capability: JSON Schemas for input and output, declared invariants, semantics, reversibility, side effects, auth model, when-to-use guidance. Plus the list of providers that implement it with current reputation snapshot. Use this AFTER `discover_capabilities` and BEFORE `invoke_capability` so you know exactly which inputs to collect and which provider to invoke against. If you skip this and call invoke_capability with the wrong shape, the response will return missing_fields or schema errors.

{
  "type": "object",
  "properties": {
    "capability_id": {
      "type": "string",
      "description": "Format: <domain>.<verb>. Example: 'booking.create_booking'. From discover_capabilities."
    }
  },
  "required": [
    "capability_id"
  ],
  "additionalProperties": false
}

Given a user intent, return a typed plan: an ordered list of capability calls that together accomplish the goal, with the highest-reputation provider per step. The plan respects the capability registry's prerequisite graph — for example a plan that includes `booking.create_booking` automatically prepends `booking.check_availability`. Use this when the user's request spans more than one verb (e.g. 'find me an open yoga slot tomorrow morning and book it'). Each step exposes capability_id, provider, conformance, p50 latency, cost, and a `prerequisite_for` array. The agent then iterates through the plan calling invoke_capability per step.

{
  "type": "object",
  "properties": {
    "intent": {
      "type": "string",
      "description": "User goal in free text."
    },
    "context": {
      "type": "object",
      "description": "Optional structured context (locale, city, urgency, cost ceiling, user_present).",
      "additionalProperties": true
    },
    "limit": {
      "type": "number",
      "description": "Max seed capabilities (prerequisites are added on top). Default 5."
    }
  },
  "required": [
    "intent"
  ],
  "additionalProperties": false
}

Given a JSON payload (something you found in user context, a webhook body, an export, a clipboard paste), return the capabilities whose input or output schema overlaps with the payload's shape. Use this when you don't have a verb-style intent but you do have data and want to ask 'what could I do with this?'. Returns matches ranked by structural overlap with `direction: 'input' | 'output' | 'both'`.

{
  "type": "object",
  "properties": {
    "payload": {
      "description": "Arbitrary JSON value whose shape will be matched against capability schemas."
    }
  },
  "required": [
    "payload"
  ],
  "additionalProperties": false
}

Return a compact roster of every capability with at least one enabled provider, grouped by category, with the best current conformance per capability. Use this as a self-introspection step: call once at the start of a task to know what is and isn't available, before deciding whether to attempt or to tell the user 'this isn't possible here'.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Execute a capability call against a chosen provider with typed inputs. WRITE tool when the capability's category ends in '.write' (creates state, sends notifications, charges money, etc.) — confirm with the user before calling for any non-reversible capability. Read capabilities (category ending '.read') are safe to call without confirmation. Validates inputs against the capability's JSON Schema. On failure, returns a structured error with 'missing_fields' or schema violation detail so you can repair without round-tripping. Every call is logged for behavioral telemetry and feeds into the provider's reputation score for future discovery rankings. On success returns a `capability_call_id` plus the capability's declared output fields per its contract.

{
  "type": "object",
  "properties": {
    "capability_id": {
      "type": "string",
      "description": "Format: <domain>.<verb>."
    },
    "provider_id": {
      "type": "string",
      "description": "Provider identifier from get_capability_spec. Format: <transport>:<id>, e.g. 'bookio:salon-aurora'."
    },
    "inputs": {
      "type": "object",
      "description": "Canonical inputs matching the capability's input JSON Schema exactly (snake_case keys).",
      "additionalProperties": true
    },
    "agent_vendor": {
      "type": "string",
      "description": "Self-identification (claude, chatgpt, cursor, ...). Strongly recommended."
    }
  },
  "required": [
    "capability_id",
    "provider_id",
    "inputs"
  ],
  "additionalProperties": false
}