Create a code tool
A code tool is authored via Ada’s MCP Server or the Platform API. There are two authoring paths: describe the tool over Ada’s MCP Server, or push code through the Platform API. Either way, add the finished tool to a Playbook step for an AI Agent to run mid-conversation, or invoke it directly like an API tool.
Author over Ada’s MCP Server (describe it)
For AI Managers who want to describe the change in plain language rather than write code. Connect an AI assistant to Ada’s MCP Server and describe the tool; the assistant writes the name, description, inputs, outputs, and code. Authoring routes through a change set: the tool is staged as a draft, you run tests against it, and it goes live only when you promote it. A promote can be reverted.
Create an API key. In the dashboard, create an API key for the AI assistant to authenticate with. The key connects the assistant to Ada’s MCP Server and the Platform API.
Connect Ada’s MCP Server. In your AI assistant, add Ada’s MCP Server using the API key. This lets the assistant create and update tools on your Agent.
Describe the tool. Tell the assistant what the tool should do: the data it works with, the inputs it takes, and the result it returns. Be specific about the output the Agent needs.
Review what was generated. Check the name, description, code, inputs, outputs, and environment variables. To change anything, ask for the change in chat rather than hand-editing the code, so the assistant keeps the tool consistent.
Test the draft. The tool is staged on a change set, not live. Run your test cases against the draft to confirm it returns what you expect.
Promote the change set. When the results look right, promote the change set to make the tool live. A promote can be reverted if you need to roll back.
(Optional) Add it to a Playbook step. The tool is live once you promote it. To have the AI Agent run it inside a specific Playbook workflow, add a step that runs the tool. This is recommended but not required: a code tool can also run on its own.
Author through the Platform API (push code)
For developers pushing code that is already written and reviewed, for example from a repository or CI pipeline. A push through the Platform API writes the tool directly: there is no draft or confirmation step. The tool then appears in the dashboard, the same as one authored over MCP.
After a tool is live
Once a code tool is live, its runs appear in the conversation view: while reviewing a conversation, open any run to see its status, inputs, outputs, and logs. A code tool also runs during a Simulation, but the Simulations view shows only that it ran, not its result. To inspect a run in full, open the conversation. Creating, updating, or deleting a code tool is recorded in the Audit log; its runs are not.
You can edit a live tool’s code from the dashboard, over Ada’s MCP Server, or through the Platform API. See Limits and best practices.