diff --git a/public/sitemap.xml b/public/sitemap.xml index dcd24913..31d3a805 100644 --- a/public/sitemap.xml +++ b/public/sitemap.xml @@ -2,840 +2,847 @@ https://kagent.dev/agents - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/blog - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/community - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/concepts/agent-harness - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/concepts/agent-memory - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/concepts/agent-substrate - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/concepts/agents - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/concepts/architecture - 2026-06-26 + 2026-07-13 + weekly + 0.8 + + + + https://kagent.dev/docs/kagent/concepts/mcp-apps + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/concepts - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/concepts/tools - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/examples/a2a-agents - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/examples/a2a-byo - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/examples/agent-harness - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/examples/agent-substrate - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/examples/agentgateway - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/examples/agents-mcp - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/examples/crewai-byo - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/examples/discord-a2a - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/examples/documentation - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/examples/human-in-the-loop - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/examples/langchain-byo - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/examples - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/examples/skills - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/examples/slack-a2a - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/examples/telegram-bot - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/getting-started/first-agent - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/getting-started/first-mcp-tool - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/getting-started/local-development - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/getting-started - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/getting-started/quickstart - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/getting-started/system-prompts - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/introduction/features - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/introduction/installation - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/introduction - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/introduction/what-is-kagent - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/observability/audit-prompts - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/observability/launch-ui - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/observability - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/observability/tracing - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/operations/debug - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/operations/operational-considerations - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/operations - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/operations/uninstall - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/operations/upgrade - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/resources/api-ref - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli/kagent-add-mcp - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli/kagent-bug-report - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli/kagent-build - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli/kagent-completion - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli/kagent-dashboard - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli/kagent-deploy - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli/kagent-get - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli/kagent-help - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli/kagent-init - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli/kagent-install - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli/kagent-invoke - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli/kagent-mcp - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli/kagent-run - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli/kagent-uninstall - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli/kagent-version - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/resources/faq - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/resources/helm - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/resources - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/resources/release-notes - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/resources/tools-ecosystem - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/supported-providers/amazon-bedrock - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/supported-providers/anthropic - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/supported-providers/azure-openai - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/supported-providers/byo-openai - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/supported-providers/gemini - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/supported-providers/google-vertexai - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/supported-providers/ollama - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/supported-providers/openai - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/supported-providers - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/supported-providers/sap-ai-core - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kagent/supported-providers/xai - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kmcp/deploy/install-controller - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kmcp/deploy - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kmcp/deploy/server - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kmcp/develop/fastmcp-python - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kmcp/develop/mcp-go - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kmcp/develop - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kmcp/introduction - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kmcp - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kmcp/quickstart - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kmcp/reference/api-ref - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kmcp/reference/kmcp-add-tool - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kmcp/reference/kmcp-build - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kmcp/reference/kmcp-completion - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kmcp/reference/kmcp-deploy - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kmcp/reference/kmcp-help - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kmcp/reference/kmcp-init - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kmcp/reference/kmcp-install - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kmcp/reference/kmcp-run - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kmcp/reference/kmcp-secrets - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kmcp/reference - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs/kmcp/secrets - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/docs - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/enterprise - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/page.tsx - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/tools - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/agents/argo-rollouts-conversion-agent - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/agents/cilium-crd-agent - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/agents/helm-agent - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/agents/istio-agent - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/agents/k8s-agent - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/agents/kgateway-agent - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/agents/observability-agent - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/agents/promql-agent - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/tools/istio - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/tools/kubernetes - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/tools/prometheus - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/tools/documentation - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/tools/helm - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/tools/argo - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/tools/grafana - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/tools/other - 2026-06-26 + 2026-07-13 weekly 0.8 https://kagent.dev/tools/cilium - 2026-06-26 + 2026-07-13 weekly 0.8 diff --git a/src/app/docs/kagent/concepts/mcp-apps/page.mdx b/src/app/docs/kagent/concepts/mcp-apps/page.mdx new file mode 100644 index 00000000..f45bb5db --- /dev/null +++ b/src/app/docs/kagent/concepts/mcp-apps/page.mdx @@ -0,0 +1,70 @@ +--- +title: "MCP Apps" +pageOrder: 7 +description: "Render interactive MCP UI widgets (MCP Apps) inline in the kagent chat and test them from the dashboard." +--- + +export const metadata = { + title: "MCP Apps in kagent", + description: "Render interactive MCP UI widgets (MCP Apps) inline in the kagent chat and test them from the dashboard.", + author: "kagent.dev" +}; + +# MCP Apps + +MCP Apps are MCP tools that ship an interactive user interface with their results. Instead of returning plain JSON, an MCP server can attach an HTML/UI **resource** to a tool using the MCP Apps extension ([`@modelcontextprotocol/ext-apps`](https://github.com/modelcontextprotocol/ext-apps)). When an agent calls such a tool, kagent renders a live widget — a form, board, chart, or dashboard — directly in the chat. + +## How it works + +An MCP server advertises an app by setting `_meta.ui.resourceUri` on a tool (for example, `ui://server-everything/weather-dashboard`). kagent detects this metadata automatically — no extra configuration is needed: + +- **Inline rendering.** When the agent calls an MCP App tool, the chat renders the app's UI resource in a sandboxed frame inside the chat message, in addition to the usual tool-call details. +- **Two-way messaging.** The app can send messages on the user's behalf, and kagent proxies the app's resource reads and tool calls back to the originating MCP server. This lets a widget update itself in place, for example by re-calling its own tool. +- **Model-result compaction.** Rich UI payloads stay in the chat history for rendering, but kagent compacts what is sent back to the model, avoiding token bloat and redundant tool churn. A tool's `_meta.ui.visibility` controls whether results are app-only or also visible to the model. + +## Discover and test apps in the dashboard + +The **MCP servers** page in the kagent dashboard lists each server's MCP Apps alongside its regular tools. The server row shows separate counts (for example, "5 tools · 1 app"), and apps are marked with a window icon. + +Clicking an app opens a standalone testing page where you can invoke the tool with JSON arguments and preview the rendered widget — without going through an agent chat. This is useful when developing your own MCP Apps. + +## Try it out + +The [Server Everything](https://servereverything.dev/mcp) reference MCP server exposes a `show-weather-dashboard` MCP App. Connect it to kagent with a `RemoteMCPServer`: + +```yaml +apiVersion: kagent.dev/v1alpha2 +kind: RemoteMCPServer +metadata: + name: server-everything + namespace: kagent +spec: + url: "https://servereverything.dev/mcp" + protocol: STREAMABLE_HTTP + timeout: 30s + sseReadTimeout: 5m0s + description: "Server Everything reference MCP server with an interactive weather dashboard MCP App" +``` + +Then reference the tool from an agent like any other MCP tool: + +```yaml +tools: + - type: McpServer + mcpServer: + apiGroup: kagent.dev + kind: RemoteMCPServer + name: server-everything + toolNames: + - show-weather-dashboard +``` + +Open the agent in the kagent UI and ask: **"show the weather dashboard"**. The dashboard renders inline in the chat and keeps itself updated in place. + +A complete example, including a demo agent, is available in the kagent repository under [`contrib/tools/server-everything`](https://github.com/kagent-dev/kagent/tree/main/contrib/tools/server-everything). + +## Learn more + +- [MCP Apps extension](https://github.com/modelcontextprotocol/ext-apps) +- [Model Context Protocol](https://modelcontextprotocol.io/) +- [Tools in kagent](/docs/kagent/concepts/tools) diff --git a/src/app/docs/kagent/concepts/page.mdx b/src/app/docs/kagent/concepts/page.mdx index aec49eca..76349a5d 100644 --- a/src/app/docs/kagent/concepts/page.mdx +++ b/src/app/docs/kagent/concepts/page.mdx @@ -24,6 +24,7 @@ import QuickLink from '@/components/quick-link'; + diff --git a/src/app/docs/kagent/concepts/tools/page.mdx b/src/app/docs/kagent/concepts/tools/page.mdx index 2b74e512..49c192e0 100644 --- a/src/app/docs/kagent/concepts/tools/page.mdx +++ b/src/app/docs/kagent/concepts/tools/page.mdx @@ -83,6 +83,10 @@ MCP stands for [Model Context Protocol](https://modelcontextprotocol.io/introduc **Note:** Double check any community servers before running them in your environment. +### MCP Apps + +Some MCP tools ship an interactive UI with their results. kagent detects these tools automatically and renders their widgets inline in the chat, and the dashboard lists them alongside a server's regular tools so you can test them directly. See [MCP Apps](/docs/kagent/concepts/mcp-apps) for details. + ## HTTP Tools HTTP tools are another way to bring external tools into kagent. Simply put, given a URL and a schema, kagent will send the user query to the URL and return the response. kagent has the ability to discovery HTTP tools from services running in the cluster, assuming they are OpenAPI Compliant. diff --git a/src/config/navigation.json b/src/config/navigation.json index 77ba7ad6..6aee3e29 100644 --- a/src/config/navigation.json +++ b/src/config/navigation.json @@ -103,6 +103,11 @@ "title": "Agent Memory", "href": "/docs/kagent/concepts/agent-memory", "description": "Enable vector-backed long-term memory for agents to learn from past interactions." + }, + { + "title": "MCP Apps", + "href": "/docs/kagent/concepts/mcp-apps", + "description": "Render interactive MCP UI widgets (MCP Apps) inline in the kagent chat and test them from the dashboard." } ] },