Appearance
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
| Tool | Description |
|---|---|
set_ongoing_task | Set/update a multi-step task so the agent remembers it across turns. |
get_ongoing_task | Retrieve the current ongoing task, if any. |
clear_ongoing_task | Clear the ongoing task after completion/cancellation. |
Memory
| Tool | Description |
|---|---|
remember | Save a durable fact about the user/conversation. Contact-scoped when a contact is present. |
recall | Retrieve a remembered value by key, or list all. |
recall_conversation | Search conversation history (keyword or semantic), across all gateways for a contact. |
search_knowledge | Search the agent's local knowledge base (uploaded docs + saved URLs). Not a web search. |
See Agent Memory.
Goals & reflection
| Tool | Description |
|---|---|
set_goal | Declare a durable objective; optionally pre-link workflows. |
update_goal | Change a goal's status, progress notes, or priority. |
list_goals | List goals with their linked workflows. |
reflect_now | Force an immediate reflection pass over recent activity. |
get_reflections | Read past reflections. |
list_draft_workflows | List workflows proposed by reflection, pending review. |
activate_draft_workflow ⚠ approval | Promote a draft workflow to active. |
See Goals & Reflection.
Media
| Tool | Description |
|---|---|
analyze_image | Analyze an uploaded image with AI vision. |
read_document | Extract text from an uploaded PDF/DOCX/TXT/MD/CSV/JSON. |
generate_image | Generate an image from a text prompt. |
Workflows
| Tool | Description |
|---|---|
list_workflows | List all workflows, with 30-day run stats and linked goals. |
find_workflow_for_goal | Semantic search for a workflow matching a vague goal. |
execute_workflow ⚠ approval | Run a workflow by name/ID. Optional goal_id attributes the run to a goal. |
get_workflow_status | Check a workflow execution's status. |
create_workflow | Create a workflow from explicit steps or a natural-language goal. |
See Visual Workflows.
Scheduling & calendar
| Tool | Description |
|---|---|
list_schedules | List scheduled tasks. |
create_schedule ⚠ approval | Create a recurring/once/delayed schedule. |
list_calendar_tasks | List calendar tasks and events. |
create_calendar_task | Create a calendar task, reminder, or recurring automation. |
edit_calendar_task | Edit an existing calendar task. |
delete_calendar_task ⚠ approval | Delete a calendar task. |
See Scheduling & Cron.
Knowledge & data
| Tool | Description |
|---|---|
list_data_sources | List knowledge-base data sources. |
execute_sql ⚠ approval | Run a SQL query against the agent database. |
Screenshots
| Tool | Description |
|---|---|
list_screenshots | List saved screenshot metadata (IDs/timestamps). |
get_screenshot | Display a screenshot (latest by default, or by ID). |
delete_screenshot | Delete a saved screenshot. |
Agent info
| Tool | Description |
|---|---|
get_agent_info | Get the current agent's configuration and capabilities. |
Contacts
| Tool | Description |
|---|---|
list_contacts | List known contacts. |
get_contact | Get details for a specific contact. |
create_contact | Create a new contact. |
update_contact | Update a contact's information. |
See Contacts.
Messaging & gateways
| Tool | Description |
|---|---|
list_gateways | List configured communication gateways. |
send_message ⚠ approval | Send a message via a gateway (Telegram, email, WhatsApp, X, etc.). |
list_conversations | List recent conversations. |
get_conversation_history | Get message history for a conversation. |
See Gateways.
Agent-to-agent
| Tool | Description |
|---|---|
list_agent_connections | List other AI agents this agent can talk to. |
send_to_agent | Send a message to a connected agent. |
See Agent Connections.
Web & browser
| Tool | Description |
|---|---|
web_search | Search the web (Bing); returns structured results. Fastest lookup path. |
fetch_url | Make an HTTP request to any URL (REST APIs, webhooks, JSON). |
web_crawl | Crawl an entire website to markdown for research/ingestion. |
get_crawl_status | Check a web_crawl job's status. |
browser_render | Fetch a public webpage as clean markdown. Fast, no login. |
browser_context | Open a full browser session; returns a sessionId + accessibility-tree snapshot. |
browser_action | Click/type/press/scroll/snapshot inside a browser session via [ref=N] numbers. |
list_browser_contexts | List saved logged-in browser contexts. |
analyze_page | Vision-AI analysis of the page screenshot; returns clickable element coordinates. |
See Browser Sessions and Browser Actions.
Custom tools & MCP
| Tool | Description |
|---|---|
list_custom_tools | List custom tools and MCP server tools. |
call_custom_tool | Invoke a custom/MCP tool by name. |
import_openapi_tools ⚠ approval | Import all endpoints from an OpenAPI spec URL as callable tools. |
update_tool_cluster | Update config (e.g. base URL) for an imported API's tool cluster. |
delete_tool_cluster | Remove a previously imported API's tools. |
See Tool Calling → OpenAPI Auto-Import and MCP Servers.
Skills marketplace
| Tool | Description |
|---|---|
learn_skill | Search the skills marketplace and install new capabilities. |
evaluate_skill | Rate a skill's performance after use. |
Payments
| Tool | Description |
|---|---|
check_balance | Check wallet balance and recent transaction summary. |
list_transactions | List payment transactions with filters. |
log_payment | Manually record a payment (bank transfer, cash, etc.). |
send_payment ⚠ approval | Send a crypto payment to an address. |
list_payment_methods | List stored payment methods (cards, wallets, bank accounts). |
create_checkout ⚠ approval | Create a Stripe checkout session to receive a card payment. |
charge_card ⚠ approval | Charge a stored card to make a payment on the agent's behalf. |
pay_mpp_resource ⚠ approval | Pay 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.
| Tool | Description |
|---|---|
stratos_addresses | List wallet addresses across all chains (Canton/EVM/BTC/Tron). |
stratos_balance | Fetch Canton CC and token balances. Returns {balances, raw}. |
stratos_transactions | Fetch recent wallet transaction history. |
stratos_transfer ⚠ approval | Transfer tokens (defaults to Canton CC). |
stratos_sign ⚠ approval | Sign 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)
| Tool | Description |
|---|---|
create_app ⚠ approval | Deploy a PWA micro-app; returns a public apps.uranus.im/{slug} URL. |
update_app | Update an app's code/settings (creates a new version). |
list_apps | List deployed apps. |
delete_app ⚠ approval | Delete 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.
Related
- Tool Calling — the agentic loop, schema format, and Code Mode
- Tools API — managing custom HTTP tools and OpenAPI imports
- Human-in-the-Loop — the approval flow
