Skip to content

Built-in Tools ​

Every Uranus agent ships with a registry of built-in tools the LLM can call during the agentic loop. This page is the complete reference — 77 tools across 16 categories.

Tools marked ⚠ approval are in TOOLS_REQUIRING_APPROVAL and pause for human confirmation before executing (see Human-in-the-Loop).

Selective loading

Not all 77 tools are sent to the model on every turn. Selective tool loading sends only the categories relevant to the request, cutting token usage substantially. See Tool Calling → Selective Tool Loading.

Task & ongoing work ​

ToolDescription
set_ongoing_taskSet/update a multi-step task so the agent remembers it across turns.
get_ongoing_taskRetrieve the current ongoing task, if any.
clear_ongoing_taskClear the ongoing task after completion/cancellation.

Memory ​

ToolDescription
rememberSave a durable fact about the user/conversation. Contact-scoped when a contact is present.
recallRetrieve a remembered value by key, or list all.
recall_conversationSearch conversation history (keyword or semantic), across all gateways for a contact.
search_knowledgeSearch the agent's local knowledge base (uploaded docs + saved URLs). Not a web search.

See Agent Memory.

Goals & reflection ​

ToolDescription
set_goalDeclare a durable objective; optionally pre-link workflows.
update_goalChange a goal's status, progress notes, or priority.
list_goalsList goals with their linked workflows.
reflect_nowForce an immediate reflection pass over recent activity.
get_reflectionsRead past reflections.
list_draft_workflowsList workflows proposed by reflection, pending review.
activate_draft_workflow ⚠ approvalPromote a draft workflow to active.

See Goals & Reflection.

Media ​

ToolDescription
analyze_imageAnalyze an uploaded image with AI vision.
read_documentExtract text from an uploaded PDF/DOCX/TXT/MD/CSV/JSON.
generate_imageGenerate an image from a text prompt.

Workflows ​

ToolDescription
list_workflowsList all workflows, with 30-day run stats and linked goals.
find_workflow_for_goalSemantic search for a workflow matching a vague goal.
execute_workflow ⚠ approvalRun a workflow by name/ID. Optional goal_id attributes the run to a goal.
get_workflow_statusCheck a workflow execution's status.
create_workflowCreate a workflow from explicit steps or a natural-language goal.

See Visual Workflows.

Scheduling & calendar ​

ToolDescription
list_schedulesList scheduled tasks.
create_schedule ⚠ approvalCreate a recurring/once/delayed schedule.
list_calendar_tasksList calendar tasks and events.
create_calendar_taskCreate a calendar task, reminder, or recurring automation.
edit_calendar_taskEdit an existing calendar task.
delete_calendar_task ⚠ approvalDelete a calendar task.

See Scheduling & Cron.

Knowledge & data ​

ToolDescription
list_data_sourcesList knowledge-base data sources.
execute_sql ⚠ approvalRun a SQL query against the agent database.

Screenshots ​

ToolDescription
list_screenshotsList saved screenshot metadata (IDs/timestamps).
get_screenshotDisplay a screenshot (latest by default, or by ID).
delete_screenshotDelete a saved screenshot.

Agent info ​

ToolDescription
get_agent_infoGet the current agent's configuration and capabilities.

Contacts ​

ToolDescription
list_contactsList known contacts.
get_contactGet details for a specific contact.
create_contactCreate a new contact.
update_contactUpdate a contact's information.

See Contacts.

Messaging & gateways ​

ToolDescription
list_gatewaysList configured communication gateways.
send_message ⚠ approvalSend a message via a gateway (Telegram, email, WhatsApp, X, etc.).
list_conversationsList recent conversations.
get_conversation_historyGet message history for a conversation.

See Gateways.

Agent-to-agent ​

ToolDescription
list_agent_connectionsList other AI agents this agent can talk to.
send_to_agentSend a message to a connected agent.

See Agent Connections.

Web & browser ​

ToolDescription
web_searchSearch the web (Bing); returns structured results. Fastest lookup path.
fetch_urlMake an HTTP request to any URL (REST APIs, webhooks, JSON).
web_crawlCrawl an entire website to markdown for research/ingestion.
get_crawl_statusCheck a web_crawl job's status.
browser_renderFetch a public webpage as clean markdown. Fast, no login.
browser_contextOpen a full browser session; returns a sessionId + accessibility-tree snapshot.
browser_actionClick/type/press/scroll/snapshot inside a browser session via [ref=N] numbers.
list_browser_contextsList saved logged-in browser contexts.
analyze_pageVision-AI analysis of the page screenshot; returns clickable element coordinates.

See Browser Sessions and Browser Actions.

Custom tools & MCP ​

ToolDescription
list_custom_toolsList custom tools and MCP server tools.
call_custom_toolInvoke a custom/MCP tool by name.
import_openapi_tools ⚠ approvalImport all endpoints from an OpenAPI spec URL as callable tools.
update_tool_clusterUpdate config (e.g. base URL) for an imported API's tool cluster.
delete_tool_clusterRemove a previously imported API's tools.

See Tool Calling → OpenAPI Auto-Import and MCP Servers.

Skills marketplace ​

ToolDescription
learn_skillSearch the skills marketplace and install new capabilities.
evaluate_skillRate a skill's performance after use.

Payments ​

ToolDescription
check_balanceCheck wallet balance and recent transaction summary.
list_transactionsList payment transactions with filters.
log_paymentManually record a payment (bank transfer, cash, etc.).
send_payment ⚠ approvalSend a crypto payment to an address.
list_payment_methodsList stored payment methods (cards, wallets, bank accounts).
create_checkout ⚠ approvalCreate a Stripe checkout session to receive a card payment.
charge_card ⚠ approvalCharge a stored card to make a payment on the agent's behalf.
pay_mpp_resource ⚠ approvalPay for an MPP (Machine Payments Protocol) HTTP-402-gated resource.

See Payments.

Stratos wallet ​

The Stratos wallet integration exposes a multi-chain wallet (Canton / EVM / BTC / Tron) configured per agent. All five tools require the agent's Stratos portal URL and API credentials to be set; without them the tools return a clear "not configured" error.

ToolDescription
stratos_addressesList wallet addresses across all chains (Canton/EVM/BTC/Tron).
stratos_balanceFetch Canton CC and token balances. Returns {balances, raw}.
stratos_transactionsFetch recent wallet transaction history.
stratos_transfer ⚠ approvalTransfer tokens (defaults to Canton CC).
stratos_sign ⚠ approvalSign a message with a key in the wallet.

The stratos_transfer tool description advises calling stratos_addresses first when unsure which chains the wallet supports. Balance parsing is defensive — if the parsed balances array is empty but the raw portal response shows non-zero balances, the tool reports the raw response verbatim so the discrepancy is visible.

Apps (Dynamic Workers) ​

ToolDescription
create_app ⚠ approvalDeploy a PWA micro-app; returns a public apps.uranus.im/{slug} URL.
update_appUpdate an app's code/settings (creates a new version).
list_appsList deployed apps.
delete_app ⚠ approvalDelete a deployed app.

See Services.

Tools requiring approval ​

The complete approval list (TOOLS_REQUIRING_APPROVAL):

send_message · execute_sql · execute_workflow · create_schedule · delete_calendar_task · import_openapi_tools · send_payment · charge_card · create_checkout · pay_mpp_resource · stratos_transfer · stratos_sign · create_app · delete_app · activate_draft_workflow

When the agent runs in a gateway conversation (Telegram, email, etc.), approval is requested through that channel; in the dashboard chat it appears inline.