Ahel

The workspace's prepaid balance in USD, what runs in flight hold, what settled runs used today and this month (shown to the Owner), any daily spend cap on the team API key this connection uses, and where to top up. Check it when a run is refused for funds, or before a job that will make many runs. Free; changes nothing. NOT for: the price of one run, which is capability_inspect.

Takes no parameters.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "balance",
    "arguments": {}
  }
}

Read one task or provider tool from Ahel's catalog by its id: its exact inputs (Ahel's own contract, or the published reference input when Ahel has none), its status and exact reason, Ahel's price per provider (Unknown when Ahel has no rate), for a temporarily unavailable item the market prices seen elsewhere, for comparison, and the exact run_capability call when it can run. With arguments it also prices that exact run before anything runs: Ahel's quote, the most it may cost, the amount a run would reserve and whether the balance covers it; nothing is reserved, charged or started. Free; changes nothing. NOT for: finding ids, which is capability_search, or running it, which is run_capability.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "capability_inspect",
    "arguments": {
      "id": "..."
    }
  }
}

Without execution_id: the paid data capabilities this workspace can run, each with its providers and exact prices. With execution_id: that run's state, attempts and exact cost, settled once in the ledger when final; with results true, its rows and provenance (include_raw true adds the provider's own answer). Generated images and audio come as a signed link (media_url, valid for days) with their type and size; a small one is also attached as an image or audio block. A long result answers as many rows as fit and says the offset that reads the rest. NOT for: finding a task or tool to run, which is capability_search.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "capability_run_status",
    "arguments": {}
  }
}

Search Ahel's catalog of data tasks and provider tools by words, a task id or a tool id: company and people enrichment, SEO, social, ads, e-commerce, reviews, AI generation, market and public data. Each result has its genuine task id or tool id, its platform, its status (ready, needs_connection, coming_soon meaning temporarily unavailable because Ahel has no provider for it yet, or unavailable while the run service is down) with the exact reason; a temporarily unavailable result may carry a market price seen elsewhere, for comparison. The same catalog, ids and statuses as the Catalog page on ahel.ai. Describe the job in plain words; results are ranked by how well they fit. When nothing fits it answers verdict none with the three nearest items: then call catalog_request. Free; changes nothing. NOT for: one item's exact inputs and prices, which is capability_inspect, or the team's own tools, which is my_tools.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "capability_search",
    "arguments": {}
  }
}

Ask Ahel to add a data task or provider tool the catalog does not have yet: call it when capability_search answers verdict none and none of its nearest items fits. Give what you need in plain words, an example input, and the most you would pay for one call. Answers a request id; asking again for the same thing adds to that request instead of making a new one. Free; runs nothing and charges nothing. NOT for: finding what already exists, which is capability_search.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "catalog_request",
    "arguments": {
      "what": "..."
    }
  }
}

Rate one run or one catalog request of this workspace good or bad, with an optional note on what was right or wrong (missing rows, wrong data, too slow). Ahel reads every rating to fix providers and the catalog. Free; changes nothing else. NOT for: reading a run's state or rows, which is capability_run_status.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "feedback",
    "arguments": {
      "id": "...",
      "rating": "good"
    }
  }
}

How to start with Ahel: call this when the person asks what Ahel is, what it can do or how to begin. Returns what Ahel is, how the prepaid balance works, the three steps to find, price and run any data task or provider tool, and ready example prompts. Reads only; changes nothing. NOT for: finding a data task or provider tool for a specific ask, which is capability_search.

Takes no parameters.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_started",
    "arguments": {}
  }
}

This team's own tools: the APIs and MCP servers the team added on ahel.ai under Your own tools. Without tool, lists each one with its tools, their inputs and the exact call. With tool ("<key>/<tool name>" from that list) and arguments, calls it with the team's saved credentials, which never enter the chat. NOT for: Ahel's catalog of data tasks and provider tools, which is capability_search. If the transport times out, do not resubmit the work: call again with the same ids and poll.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "my_tools",
    "arguments": {}
  }
}

Rate how useful one finished run of this workspace was, after you have used its result: useful, partly, not_useful, or not_sure when you cannot tell, with an optional reason about the result (missing rows, wrong data, stale). One review per run; reviewing it again replaces the earlier one. Ahel reads every review to rank and fix providers. Leave out private information, keys and raw rows. Free; changes nothing else. NOT for: a catalog request, or reporting something confusing or broken, which is feedback.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "review",
    "arguments": {
      "run_id": "...",
      "usefulness": "useful"
    }
  }
}

Run one paid data capability (company data, people and contact data and the like) through Ahel's provider execution: it is quoted, the exact price is reserved from the workspace balance, and the run starts. Give id, a task id or tool id from capability_search: it runs only through the v2 capability Ahel's task map binds to it, and an item that is not ready is refused with its exact reason before anything is quoted. It then waits up to wait_seconds (default 20, at most 50; 0 answers at once): when the run finishes in that time, this same answer has its state, exact cost and rows, and generated images and audio as links; otherwise it answers the execution id, and capability_run_status reads the run. Data collection only: a capability that writes or has a side effect is refused. Ahel picks the provider unless endpoint_ids pins one; exclude_endpoint_ids leaves providers out. Give idempotency_key so a retry after a lost answer is safe: the same key answers the same run, with no new charge. Give tag (such as a customer name) to see usage and cost by tag in Activity. NOT for: the team's own tools, which is my_tools.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "run_capability",
    "arguments": {
      "arguments": {}
    }
  }
}