Precision MCP connection guide
Production MCP tool reference
Snapshot as of , from AI-Trading-Signals/os commit 6991f85fc. The live server's tools/list is authoritative.
44 production tools: 19 read-only, 10 additive writes and 15 destructive writes; 3 also have the open-world annotation. Open-world tools can initiate agent or routine work; their sends and changes still wait for approval by default in the app.
9 firm-content tools exist and are off in production; excluded below. Each row shows the tool's title, a short description and all four MCP annotation hints. These hints describe behavior; they do not grant access. Read the plain-text MCP catalog.
Read-only tools (19)
Read setup information, status and counts without changing them.
| Tool | What it does | MCP annotations |
|---|---|---|
get_agentRead an agent | Read an agent's draft, published version and settings. | readOnlyHint: truedestructiveHint: falseidempotentHint: trueopenWorldHint: false |
list_routinesList routines | Read routines' state, schedule, owner and skills. | readOnlyHint: truedestructiveHint: falseidempotentHint: trueopenWorldHint: false |
routine_statusCheck a routine | Check a routine's state, next run and starts, without its findings. | readOnlyHint: truedestructiveHint: falseidempotentHint: trueopenWorldHint: false |
list_websitesList websites | List the websites agents may use and how each signs in. | readOnlyHint: truedestructiveHint: falseidempotentHint: trueopenWorldHint: false |
list_signinsList website sign-ins | Check website sign-in health; people still sign in themselves in the app. | readOnlyHint: truedestructiveHint: falseidempotentHint: trueopenWorldHint: false |
list_firm_loginsList firm logins | List shared website logins and who may use each. | readOnlyHint: truedestructiveHint: falseidempotentHint: trueopenWorldHint: false |
get_firm_settingsRead firm settings | Read settings such as the firm's time zone and team brief. | readOnlyHint: truedestructiveHint: falseidempotentHint: trueopenWorldHint: false |
get_rulesRead Rules | Read the firm's Rules for connected-app actions. | readOnlyHint: truedestructiveHint: falseidempotentHint: trueopenWorldHint: false |
list_modelsList models | List model IDs and names available to agents or the firm. | readOnlyHint: truedestructiveHint: falseidempotentHint: trueopenWorldHint: false |
get_firm_modelRead the firm model | Read the firm's default model; agents can have their own. | readOnlyHint: truedestructiveHint: falseidempotentHint: trueopenWorldHint: false |
model_spendRead model spending | Read model spending, calls, failures, tokens and timing by call type and model. | readOnlyHint: truedestructiveHint: falseidempotentHint: trueopenWorldHint: false |
mcp_usageRead MCP usage | Read each tool's call counts, failures, error codes and average time. | readOnlyHint: truedestructiveHint: falseidempotentHint: trueopenWorldHint: false |
list_connected_appsList connected apps | Check connected-app status; people connect their own accounts in the app. | readOnlyHint: truedestructiveHint: falseidempotentHint: trueopenWorldHint: false |
job_statusCheck a job | Check whether a job is running, waiting, done or failed, without its findings. | readOnlyHint: truedestructiveHint: falseidempotentHint: trueopenWorldHint: false |
list_skillsList skills | List skills, revisions, the agents using them and available app or website references. | readOnlyHint: truedestructiveHint: falseidempotentHint: trueopenWorldHint: false |
get_skillRead a skill | Read a skill's folder, files, apps and revisions. | readOnlyHint: truedestructiveHint: falseidempotentHint: trueopenWorldHint: false |
list_agentsList agents | List agents and the people who can own a routine. | readOnlyHint: truedestructiveHint: falseidempotentHint: trueopenWorldHint: false |
list_client_sourcesList client sources | Read saved client-import mappings and their versions. | readOnlyHint: truedestructiveHint: falseidempotentHint: trueopenWorldHint: false |
get_guideRead the setup guide | Read the guide to setting up agents, skills, routines, logins, Rules and firm work. | readOnlyHint: truedestructiveHint: falseidempotentHint: trueopenWorldHint: false |
Additive writes (10)
Add information or save a revision with conflict protection. Writes are not retry-safe: each call adds an audit record.
| Tool | What it does | MCP annotations |
|---|---|---|
create_agentCreate an agent | Create a named agent as a draft, ready to edit and publish. | readOnlyHint: falsedestructiveHint: falseidempotentHint: falseopenWorldHint: false |
publish_agentPublish an agent | Publish an agent's draft as its next version. | readOnlyHint: falsedestructiveHint: falseidempotentHint: falseopenWorldHint: false |
add_firm_loginAdd a firm login | Add a shared website login; an owner or operator signs in through the app. Not for mail. | readOnlyHint: falsedestructiveHint: falseidempotentHint: falseopenWorldHint: false |
create_noteCreate a note | Add a titled markdown note to Agent OS (AOS), optionally linked to a client. | readOnlyHint: falsedestructiveHint: falseidempotentHint: falseopenWorldHint: false |
save_noteSave a note | Replace a note's text with a revision check; stale revisions are refused. | readOnlyHint: falsedestructiveHint: falseidempotentHint: falseopenWorldHint: false |
rename_noteRename a note | Change a note's title while keeping its links. | readOnlyHint: falsedestructiveHint: falseidempotentHint: falseopenWorldHint: false |
add_clientAdd a client | Add one client by name; bulk imports go through an agent. | readOnlyHint: falsedestructiveHint: falseidempotentHint: falseopenWorldHint: false |
ask_agentGive an agent workOpen-world | Give an agent work and receive task and job IDs, without its reply. Sends and changes wait for approval by default. | readOnlyHint: falsedestructiveHint: falseidempotentHint: falseopenWorldHint: true |
save_skillSave a skill | Save a skill folder as its next revision; a stale revision is refused. | readOnlyHint: falsedestructiveHint: falseidempotentHint: falseopenWorldHint: false |
create_routineCreate a routineOpen-world | Create a routine with an owner, instructions and skills, on a schedule or supported trigger; optionally start it. | readOnlyHint: falsedestructiveHint: falseidempotentHint: falseopenWorldHint: true |
Destructive writes (15)
Can overwrite without a revision check, stop work or remove access. Review the action before calling.
| Tool | What it does | MCP annotations |
|---|---|---|
save_agent_draftSave an agent draft | Replace an agent's full draft; publish separately to make it available. | readOnlyHint: falsedestructiveHint: trueidempotentHint: falseopenWorldHint: false |
set_agent_for_personSet an agent for a person | Turn an agent on or off for one person; existing routines keep running. | readOnlyHint: falsedestructiveHint: trueidempotentHint: falseopenWorldHint: false |
control_routineControl a routineOpen-world | Pause, resume, stop or test-run a routine. Stop cannot be undone; sends and changes still need approval. | readOnlyHint: falsedestructiveHint: trueidempotentHint: falseopenWorldHint: true |
set_routine_scheduleSet a routine schedule | Set when a routine runs on its owner's clock, or only when something arrives. | readOnlyHint: falsedestructiveHint: trueidempotentHint: falseopenWorldHint: false |
set_routine_hearsSet who hears from a routine | Set which current firm members hear from a routine besides its owner. | readOnlyHint: falsedestructiveHint: trueidempotentHint: falseopenWorldHint: false |
set_routine_skillsSet routine skills | Set the skills a routine uses. | readOnlyHint: falsedestructiveHint: trueidempotentHint: falseopenWorldHint: false |
save_websiteSave a website | Add or change a website agents may use; changes through its forms remain on approval cards. | readOnlyHint: falsedestructiveHint: trueidempotentHint: falseopenWorldHint: false |
allow_firm_loginSet firm login access | Allow or remove a person's or routine's access to a shared login. | readOnlyHint: falsedestructiveHint: trueidempotentHint: falseopenWorldHint: false |
save_firm_settingsSave firm settings | Change firm settings; omitted settings stay as they are. | readOnlyHint: falsedestructiveHint: trueidempotentHint: falseopenWorldHint: false |
set_app_ruleSet an app Rule | Change a connected app's Rule for one class of action. | readOnlyHint: falsedestructiveHint: trueidempotentHint: falseopenWorldHint: false |
archive_noteArchive a note | Archive a note so agents stop using it, or restore it. | readOnlyHint: falsedestructiveHint: trueidempotentHint: falseopenWorldHint: false |
set_firm_modelSet the firm model | Set the firm's default model or return to the platform default. | readOnlyHint: falsedestructiveHint: trueidempotentHint: falseopenWorldHint: false |
save_templateSave a template | Save the steps used to lay out imported work. | readOnlyHint: falsedestructiveHint: trueidempotentHint: falseopenWorldHint: false |
save_work_sourceSave a work source | Save a checked mapping from a work file to projects as its next version. | readOnlyHint: falsedestructiveHint: trueidempotentHint: falseopenWorldHint: false |
save_client_sourceSave a client source | Save a client-import mapping checked by a person as its next version. | readOnlyHint: falsedestructiveHint: trueidempotentHint: falseopenWorldHint: false |