feat(appkit): update tool/mcp API

Signed-off-by: Hubert Zub <hubert.zub@databricks.com>

Author: hubertzub-db

apps/dev-playground/server/index.ts

@@ -43,8 +43,8 @@ createApp({
   ],
   ...(process.env.APPKIT_E2E_TEST && { client: createMockClient() }),
 }).then(async (appkit) => {
-  // Add tools (and optionally MCP servers) after app creation
-  await appkit.agent.addCapabilities({ tools: [demoTools.timeTool] });
+  // Add tools after app creation
+  await appkit.agent.addTools([demoTools.timeTool]);
 
   appkit.server
     .extend((app) => {

…cs/api/appkit/Interface.StandardAgent.md …s/docs/api/appkit/Class.StandardAgent.mddocs/docs/api/appkit/Interface.StandardAgent.md renamed to docs/docs/api/appkit/Class.StandardAgent.md docs/docs/api/appkit/Interface.StandardAgent.md renamed to docs/docs/api/appkit/Class.StandardAgent.md

@@ -1,4 +1,4 @@
-# Interface: StandardAgent
+# Class: StandardAgent
 
 Built-in [AgentInterface](Interface.AgentInterface.md) implementation that wraps a LangGraph
 `createReactAgent` and translates its stream events into Responses API
@@ -9,6 +9,25 @@ implementation for a different LLM SDK.
 
 - [`AgentInterface`](Interface.AgentInterface.md)
 
+## Constructors
+
+### Constructor
+
+```ts
+new StandardAgent(agent: LangGraphAgent, systemPrompt: string): StandardAgent;
+```
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `agent` | `LangGraphAgent` |
+| `systemPrompt` | `string` |
+
+#### Returns
+
+`StandardAgent`
+
 ## Methods
 
 ### invoke()
@@ -25,13 +44,11 @@ invoke(params: InvokeParams): Promise<ResponseOutputItem[]>;
 
 #### Returns
 
-`Promise`\<`ResponseOutputItem`[]\>
+`Promise`\<[`ResponseOutputItem`](TypeAlias.ResponseOutputItem.md)[]\>
 
 #### Implementation of
 
-```ts
-AgentInterface.invoke
-```
+[`AgentInterface`](Interface.AgentInterface.md).[`invoke`](Interface.AgentInterface.md#invoke)
 
 ***
 
@@ -53,6 +70,4 @@ stream(params: InvokeParams): AsyncGenerator<ResponseStreamEvent>;
 
 #### Implementation of
 
-```ts
-AgentInterface.stream
-```
+[`AgentInterface`](Interface.AgentInterface.md).[`stream`](Interface.AgentInterface.md#stream)

docs/docs/api/appkit/Function.createInvokeHandler.md

@@ -0,0 +1,18 @@
+# Function: createInvokeHandler()
+
+```ts
+function createInvokeHandler(getAgent: () => AgentInterface): RequestHandler;
+```
+
+Create an Express handler that invokes the agent via the AgentInterface
+and streams/returns the response in Responses API format.
+
+## Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `getAgent` | () => [`AgentInterface`](Interface.AgentInterface.md) |
+
+## Returns
+
+`RequestHandler`

docs/docs/api/appkit/Function.isFunctionTool.md

@@ -0,0 +1,15 @@
+# Function: isFunctionTool()
+
+```ts
+function isFunctionTool(t: unknown): t is FunctionTool;
+```
+
+## Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `t` | `unknown` |
+
+## Returns
+
+`t is FunctionTool`

docs/docs/api/appkit/Function.isHostedTool.md

@@ -0,0 +1,15 @@
+# Function: isHostedTool()
+
+```ts
+function isHostedTool(t: unknown): t is HostedTool;
+```
+
+## Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `t` | `unknown` |
+
+## Returns
+
+`t is HostedTool`

docs/docs/api/appkit/Interface.AgentInterface.md

@@ -22,7 +22,7 @@ invoke(params: InvokeParams): Promise<ResponseOutputItem[]>;
 
 #### Returns
 
-`Promise`\<`ResponseOutputItem`[]\>
+`Promise`\<[`ResponseOutputItem`](TypeAlias.ResponseOutputItem.md)[]\>
 
 ***
 

docs/docs/api/appkit/Interface.CustomMcpServerTool.md

@@ -0,0 +1,32 @@
+# Interface: CustomMcpServerTool
+
+## Properties
+
+### custom\_mcp\_server
+
+```ts
+custom_mcp_server: {
+  app_name: string;
+  app_url: string;
+};
+```
+
+#### app\_name
+
+```ts
+app_name: string;
+```
+
+#### app\_url
+
+```ts
+app_url: string;
+```
+
+***
+
+### type
+
+```ts
+type: "custom_mcp_server";
+```

docs/docs/api/appkit/Interface.ExternalMcpServerTool.md

@@ -0,0 +1,25 @@
+# Interface: ExternalMcpServerTool
+
+## Properties
+
+### external\_mcp\_server
+
+```ts
+external_mcp_server: {
+  connection_name: string;
+};
+```
+
+#### connection\_name
+
+```ts
+connection_name: string;
+```
+
+***
+
+### type
+
+```ts
+type: "external_mcp_server";
+```

docs/docs/api/appkit/Interface.GenieTool.md

@@ -0,0 +1,31 @@
+# Interface: GenieTool
+
+OpenResponses-style hosted tool definitions for Databricks services.
+
+These types follow the OpenResponses convention of discriminating on `type`.
+Internally, each hosted tool is resolved to a DatabricksMCPServer instance
+so the agent can call managed MCP endpoints on the workspace.
+
+## Properties
+
+### genie\_space
+
+```ts
+genie_space: {
+  id: string;
+};
+```
+
+#### id
+
+```ts
+id: string;
+```
+
+***
+
+### type
+
+```ts
+type: "genie";
+```

docs/docs/api/appkit/Interface.IAgentConfig.md

@@ -49,16 +49,6 @@ Max tokens to generate (default 2000). Ignored when `agentInstance` is provided.
 
 ***
 
-### mcpServers?
-
-```ts
-optional mcpServers: DatabricksMCPServer[];
-```
-
-MCP servers for Databricks tool integration. Ignored when `agentInstance` is provided.
-
-***
-
 ### model?
 
 ```ts
@@ -121,8 +111,10 @@ Sampling temperature (0.0-1.0, default 0.1). Ignored when `agentInstance` is pro
 optional tools: AgentTool[];
 ```
 
-Tools to register with the agent. Accepts OpenResponses-aligned FunctionTool
-objects or LangChain StructuredToolInterface instances.
+Tools to register with the agent. Accepts:
+- OpenResponses-aligned `FunctionTool` objects (local tool with execute handler)
+- Databricks hosted tools (`genie`, `vector_search_index`, `custom_mcp_server`, `external_mcp_server`)
+
 Ignored when `agentInstance` is provided.
 
 ***