Tools: named capabilities supplied by SDK and MCP sources
Tools are named, typed capabilities that an execution can request, supplied from an SDK Tool Host or an MCP Connection.
Tools are named, typed capabilities an execution can request, supplied from an SDK Tool Host or an MCP Connection.
- SDK Tool Host serves custom functions; MCP Connection assigns remote server Tools to Agent Identities.
- Duale AI reads the current active Tool set before every model turn, including continuations.
- Assignment makes a Tool eligible for an Agent Identity without guaranteeing the call succeeds.
- Duale AI assigns each Tool a short unique model-facing name and qualifies colliding names.
Summaries were generated by AI.
A Tool is a named, typed capability that an execution can request. Supply Tools from one of two customer-controlled sources: an SDK Tool Host process in your application or an MCP Connection to a remote MCP server.
The customer Tool Host serves your SDK functions. It is a separate product from a customer-hosted Platform deployment and does not run the Duale AI Platform.
Choose how to supply Tools
- Source
- SDK Tool Host
- Use it when
- You need custom code, a controlled schema lifecycle, or a customer-managed approval step
- Who runs the Tool
- Your application process
- How it becomes available
- The SDK publishes a Tool manifest for one Agent Identity and keeps it current
- Source
- MCP Connection
- Use it when
- An existing remote MCP server already exposes the capabilities you need
- Who runs the Tool
- The remote MCP server
- How it becomes available
- An authorized tenant member configures one named Connection and assigns it to Agent Identities; its current compatible Tools can then become eligible
Continue with the control you own
- To build and serve a custom function, author SDK Tools.
- To configure and assign a remote server, connect an MCP server. Its access requirements follow the Identity authorization model.
- To inspect availability, names, outcomes, and use by Agent Identity, operate Tools.
- To check MCP compatibility and call limits or look up the Tool catalog API, use the Tools reference.
- To size a catalog, or to find out how many Tools one Agent Identity can hold, read Tool limits.
- To protect external actions, build a secure integration.
The Documentation MCP server serves a different purpose. It lets external AI clients search these public pages. It does not add executable Tools to a Duale AI Agent Identity.
Keep the four objects separate
- Object
- Tool
- Meaning
- One operation a model can request through a name and input schema
- Object
- Tool Source
- Meaning
- The SDK Tool Host or MCP Connection that identifies where the Tool comes from and who runs it
- Object
- MCP Connection
- Meaning
- One named organization configuration for a remote server, endpoint, remote access, assignment list, and call policy
- Object
- Agent Identity assignment
- Meaning
- The Agent Identities for which a Source’s current compatible Tools can become eligible
Assignment makes a Tool eligible for an Agent Identity. It does not prove that the remote operation is safe, authorize its business effect, or guarantee that a call will succeed.
Understand how the available set changes
Duale AI reads the current active Tool set before every model turn, including a continuation. An SDK Tool Host can publish a new manifest. An MCP server can change its catalog at any time. A later model turn can therefore receive a different Tool set or different model-facing names without a change to the Task interface.
Duale AI gives every exposed Tool a short, unique model-facing name. It keeps the Tool Source and native name so it can route a call to the correct Tool. If names collide, Duale AI qualifies every colliding name consistently. Distinct Sources remain distinct even when their Tools have identical schemas because they can use different credentials and data.
Agent harness defines Tool Call, Tool Result, Effect, and the other runtime concepts used in this section.