Skip to Content
supedocs

MCP tools

What an MCP client sees at https://service.oex.sh/mcp.

The server also sends the agent instructions: the find, inspect, run loop; prices in credits; asking before anything that can't be undone; and collecting long jobs. You don't need to add your own.

Tools

ToolWhat it doesChanges anything
find_toolTools for a job in plain words, with price and tags. Filter by tag, provider, max_price.No
inspect_toolOne tool's parameters by part, price, docs and alternativesNo
execute_toolRun a tool with tool_id and input ({path, query, body}). Takes run_id, or budget and goal to open a run, and confirmation.Yes, billed
start_runOpen a run with a budget and goal; returns its run_idYes
get_runA run's receiptNo
get_jobCollect a long job by job_idNo
add_fileMake a link for a file: a one-time upload page, or a copy of a urlYes
list_filesFiles in the workspaceNo
wallet_balanceBalance and what's held, in creditsNo
list_rentalsRented numbers and inboxesNo
release_rentalStop renewing a rental. Can't be undone.Yes
request_approvalAsk a person for a tool (tool_access) or more budgetYes
find_recipeSearch recipesNo
get_recipeA recipe's inputs and stepsNo
save_recipeCopy a Cookbook recipe, or save a new oneYes

Prompt

recipe takes a recipe's id or name and starts the agent on it.

Refusals

A refused call isn't an error. It comes back with a reason (budget, balance, limit, disabled, frozen) and a next step, and the agent tells you. execute_tool returns status: "needs_confirmation" for anything that needs your yes. See Confirmations.

On this page