From 7b449a8b0b6cbca1a5c3f158594b4aadda85682f Mon Sep 17 00:00:00 2001 From: Art Berger Date: Wed, 29 Oct 2025 08:54:18 -0400 Subject: [PATCH 1/4] note Signed-off-by: Art Berger --- src/app/docs/kagent/resources/release-notes/page.mdx | 2 ++ 1 file changed, 2 insertions(+) diff --git a/src/app/docs/kagent/resources/release-notes/page.mdx b/src/app/docs/kagent/resources/release-notes/page.mdx index 9a8cbbb..ef9898a 100644 --- a/src/app/docs/kagent/resources/release-notes/page.mdx +++ b/src/app/docs/kagent/resources/release-notes/page.mdx @@ -16,6 +16,8 @@ export const metadata = { The kagent documentation shows information only for the latest release. If you run an older version, review the release notes to understand the main changes from version to version. +For more details on the changes between versions, review the [kagent GitHub releases](https://github.com/kagent-dev/kagent/releases). + # v0.7 Review the main changes from kagent version 0.6 to v0.7, then continue reading for more detailed information. From 9519811a1c9244b55c460c483ddffa37c8025bdb Mon Sep 17 00:00:00 2001 From: Art Berger Date: Wed, 29 Oct 2025 10:41:15 -0400 Subject: [PATCH 2/4] Update for discovery label Signed-off-by: Art Berger --- public/sitemap.xml | 228 ++++++++++-------- src/app/docs/kagent/concepts/tools/page.mdx | 8 + .../kagent/resources/release-notes/page.mdx | 9 +- src/app/docs/kmcp/deploy/server/page.mdx | 4 +- 4 files changed, 147 insertions(+), 102 deletions(-) diff --git a/public/sitemap.xml b/public/sitemap.xml index 9fe9155..943497e 100644 --- a/public/sitemap.xml +++ b/public/sitemap.xml @@ -2,658 +2,686 @@ https://kagent.dev/agents - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/blog - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/community - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/concepts/agents - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/concepts/architecture - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/concepts - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/concepts/tools - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/examples/a2a-agents - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/examples/a2a-byo - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/examples/crewai-byo - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/examples/discord-a2a - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/examples/documentation - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/examples/langchain-byo - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/examples - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/examples/slack-a2a - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/getting-started/first-agent - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/getting-started/first-mcp-tool - 2025-10-28 + 2025-10-29 + weekly + 0.8 + + + + https://kagent.dev/docs/kagent/getting-started/local-development + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/getting-started - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/getting-started/quickstart - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/getting-started/system-prompts - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/getting-started/tracing - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/introduction/installation - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/introduction - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/introduction/what-is-kagent - 2025-10-28 + 2025-10-29 + weekly + 0.8 + + + + https://kagent.dev/docs/kagent/operations/debug + 2025-10-29 + weekly + 0.8 + + + + https://kagent.dev/docs/kagent/operations + 2025-10-29 + weekly + 0.8 + + + + https://kagent.dev/docs/kagent/operations/uninstall + 2025-10-29 + weekly + 0.8 + + + + https://kagent.dev/docs/kagent/operations/upgrade + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/resources/api-ref - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli/kagent-add-mcp - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli/kagent-bug-report - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli/kagent-build - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli/kagent-dashboard - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli/kagent-deploy - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli/kagent-get - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli/kagent-init - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli/kagent-install - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli/kagent-invoke - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli/kagent-mcp - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli/kagent-run - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli/kagent-uninstall - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli/kagent-version - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/resources/faq - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/resources/helm - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/resources - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/resources/release-notes - 2025-10-28 - weekly - 0.8 - - - - https://kagent.dev/docs/kagent/resources/troubleshooting - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/supported-providers/amazon-bedrock - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/supported-providers/anthropic - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/supported-providers/azure-openai - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/supported-providers/byo-openai - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/supported-providers/gemini - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/supported-providers/google-vertexai - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/supported-providers/ollama - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/supported-providers/openai - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kagent/supported-providers - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kmcp/deploy/install-controller - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kmcp/deploy - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kmcp/deploy/server - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kmcp/develop/fastmcp-python - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kmcp/develop/mcp-go - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kmcp/develop - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kmcp/introduction - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kmcp - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kmcp/quickstart - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kmcp/reference/api-ref - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kmcp/reference/kmcp-add-tool - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kmcp/reference/kmcp-build - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kmcp/reference/kmcp-deploy - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kmcp/reference/kmcp-init - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kmcp/reference/kmcp-install - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kmcp/reference/kmcp-run - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kmcp/reference/kmcp-secrets - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kmcp/reference - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs/kmcp/secrets - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/docs - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/enterprise - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/page.tsx - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/tools - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/agents/argo-rollouts-conversion-agent - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/agents/cilium-crd-agent - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/agents/helm-agent - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/agents/istio-agent - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/agents/k8s-agent - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/agents/kgateway-agent - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/agents/observability-agent - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/agents/promql-agent - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/tools/istio - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/tools/kubernetes - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/tools/prometheus - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/tools/documentation - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/tools/helm - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/tools/argo - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/tools/grafana - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/tools/other - 2025-10-28 + 2025-10-29 weekly 0.8 https://kagent.dev/tools/cilium - 2025-10-28 + 2025-10-29 weekly 0.8 diff --git a/src/app/docs/kagent/concepts/tools/page.mdx b/src/app/docs/kagent/concepts/tools/page.mdx index 6730a8b..46397f8 100644 --- a/src/app/docs/kagent/concepts/tools/page.mdx +++ b/src/app/docs/kagent/concepts/tools/page.mdx @@ -35,3 +35,11 @@ MCP stands for [Model Context Protocol](https://modelcontextprotocol.io/introduc ## 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. + +## Build your own tools with kmcp + +A subproject of kagent, kmcp provides a powerful CLI tool with built-in boilerplates to speed up the local development of MCP servers and MCP tools. Then, you can use the kmcp control plane to quickly spin up and deploy your MCP servers in your cloud-native environment, such as Kubernetes. + +By default, kmcp is installed with kagent. If you already installed kmcp separately, you can set `kmcp.enabled=false` in your `values.yaml` file or `--set` commands for both the `kagent` and `kagent-crds` charts. + +Planning to use your kmcp resources later with kagent and agentgateway? Add the `kagent.dev/discovery=disabled` label to your MCPServer resource. Then, kagent does not automatically discover MCP servers. This way, you can have agentgateway in front of your kmcp servers so that the agent-tool traffic is routed correctly through agentgateway. diff --git a/src/app/docs/kagent/resources/release-notes/page.mdx b/src/app/docs/kagent/resources/release-notes/page.mdx index ef9898a..b42eaa2 100644 --- a/src/app/docs/kagent/resources/release-notes/page.mdx +++ b/src/app/docs/kagent/resources/release-notes/page.mdx @@ -23,7 +23,8 @@ For more details on the changes between versions, review the [kagent GitHub rele Review the main changes from kagent version 0.6 to v0.7, then continue reading for more detailed information. * kmcp is installed by default when you install kagent -* New! Develop agents locally without a Kubernetes cluster +* New feature to develop agents locally without a Kubernetes cluster +* New `kgateway.dev/discovery` label ## kmcp installed by default @@ -59,6 +60,12 @@ Develop and test agents locally on your machine without needing a Kubernetes clu For more information, see the [local development](/docs/kagent/getting-started/local-development) guide. +## Discovery label + +Now, you can add a discovery label to MCPServer kmcp resources. By default, discovery is enabled. + +If you plan to use your kmcp resources later with kagent and agentgateway, add the `kagent.dev/discovery=disabled` label to your MCPServer resource. Then, kagent does not automatically discover MCP servers. This way, you can have agentgateway in front of your kmcp servers so that the agent-tool traffic is routed correctly through agentgateway. + # v0.6 Review the main changes from kagent version 0.5 to v0.6, then continue reading for more detailed information. diff --git a/src/app/docs/kmcp/deploy/server/page.mdx b/src/app/docs/kmcp/deploy/server/page.mdx index ca2db93..a31a007 100644 --- a/src/app/docs/kmcp/deploy/server/page.mdx +++ b/src/app/docs/kmcp/deploy/server/page.mdx @@ -99,7 +99,9 @@ The following example assumes that you created a [FastMCP](/docs/kmcp/develop/fa kmcp build --project-dir my-mcp-server -t my-mcp-server:latest --kind-load-cluster kind ``` -2. Deploy your MCP server. Choose between the kmcp CLI or manually creating an MCPServer resource. +2. Deploy your MCP server. Choose between the kmcp CLI or manually creating an MCPServer resource. + + > **Note**: Planning to use your kmcp resources later with kagent and agentgateway? Add the `kagent.dev/discovery=disabled` label to your MCPServer resource. Then, kagent does not automatically discover MCP servers. This way, you can have agentgateway in front of your kmcp servers so that the agent-tool traffic is routed correctly through agentgateway. Date: Wed, 29 Oct 2025 10:59:08 -0400 Subject: [PATCH 3/4] Add profiles and resource limits/requests Signed-off-by: Art Berger --- .../getting-started/quickstart/page.mdx | 2 +- .../kagent/introduction/installation/page.mdx | 22 ++++++++++--------- .../kagent/resources/release-notes/page.mdx | 9 ++++++++ 3 files changed, 22 insertions(+), 11 deletions(-) diff --git a/src/app/docs/kagent/getting-started/quickstart/page.mdx b/src/app/docs/kagent/getting-started/quickstart/page.mdx index 74903ea..97bfb4b 100644 --- a/src/app/docs/kagent/getting-started/quickstart/page.mdx +++ b/src/app/docs/kagent/getting-started/quickstart/page.mdx @@ -38,7 +38,7 @@ To run the AI agents you'll also need an [OpenAI](https://openai.com) API key. Y curl https://raw.githubusercontent.com/kagent-dev/kagent/refs/heads/main/scripts/get-kagent | bash ``` -3. Install kagent to the cluster by using the CLI. +3. Install kagent to the cluster by using the CLI. By default, kagent installs a demo profile with agents and MCP tools preloaded for you. If you don't want these default agents, include the `--profile minimal` flag. ```bash kagent install diff --git a/src/app/docs/kagent/introduction/installation/page.mdx b/src/app/docs/kagent/introduction/installation/page.mdx index 162c3d9..348c63e 100644 --- a/src/app/docs/kagent/introduction/installation/page.mdx +++ b/src/app/docs/kagent/introduction/installation/page.mdx @@ -35,7 +35,7 @@ Install kagent by using the kagent CLI or Helm. curl https://raw.githubusercontent.com/kagent-dev/kagent/refs/heads/main/scripts/get-kagent | bash ``` -3. Install kagent to the cluster by using the CLI. +3. Install kagent to the cluster by using the CLI. By default, kagent installs a demo profile with agents and MCP tools preloaded for you. If you don't want these default agents, include the `--profile minimal` flag. ```bash kagent install @@ -58,16 +58,18 @@ Another way to install kagent is using Helm. --create-namespace ``` +2. Optionally prepare a Helm values file or `--set` flags to use for your installation. For example, you might set up your default LLM provider, or configure resource requests and limits or disable the default agents. For options, refer to the [Helm reference docs](/docs/kagent/resources/helm). +
-2. Set the `OPENAI_API_KEY` environment variable: +3. Set the `OPENAI_API_KEY` environment variable: ```bash export OPENAI_API_KEY="your-api-key-here" ``` -3. Install the kagent Helm chart: +4. Install the kagent Helm chart: ```bash helm install kagent oci://ghcr.io/kagent-dev/kagent/helm/kagent \ @@ -78,13 +80,13 @@ Another way to install kagent is using Helm.
-2. Set the `ANTHROPIC_API_KEY` environment variable: +3. Set the `ANTHROPIC_API_KEY` environment variable: ```bash export ANTHROPIC_API_KEY="your-api-key-here" ``` -3. Install the kagent Helm chart: +4. Install the kagent Helm chart: ```bash helm install kagent oci://ghcr.io/kagent-dev/kagent/helm/kagent \ @@ -95,13 +97,13 @@ Another way to install kagent is using Helm.
-2. Set the `OPENAI_API_KEY` environment variable: +3. Set the `OPENAI_API_KEY` environment variable: ```bash export OPENAI_API_KEY="your-api-key-here" ``` -3. Install the kagent Helm chart: +4. Install the kagent Helm chart: ```bash helm install kagent oci://ghcr.io/kagent-dev/kagent/helm/kagent \ @@ -113,13 +115,13 @@ Another way to install kagent is using Helm.
-2. Set the `GEMINI_API_KEY` environment variable: +3. Set the `GEMINI_API_KEY` environment variable: ```bash export GEMINI_API_KEY="your-api-key-here" ``` -3. Install the kagent Helm chart: +4. Install the kagent Helm chart: ```bash helm install kagent oci://ghcr.io/kagent-dev/kagent/helm/kagent \ @@ -131,7 +133,7 @@ Another way to install kagent is using Helm.
-2. Install the kagent Helm chart: +3. Install the kagent Helm chart: ```bash helm install kagent oci://ghcr.io/kagent-dev/kagent/helm/kagent \ diff --git a/src/app/docs/kagent/resources/release-notes/page.mdx b/src/app/docs/kagent/resources/release-notes/page.mdx index b42eaa2..85a7086 100644 --- a/src/app/docs/kagent/resources/release-notes/page.mdx +++ b/src/app/docs/kagent/resources/release-notes/page.mdx @@ -25,6 +25,7 @@ Review the main changes from kagent version 0.6 to v0.7, then continue reading f * kmcp is installed by default when you install kagent * New feature to develop agents locally without a Kubernetes cluster * New `kgateway.dev/discovery` label +* Installation profiles ## kmcp installed by default @@ -66,6 +67,14 @@ Now, you can add a discovery label to MCPServer kmcp resources. By default, disc If you plan to use your kmcp resources later with kagent and agentgateway, add the `kagent.dev/discovery=disabled` label to your MCPServer resource. Then, kagent does not automatically discover MCP servers. This way, you can have agentgateway in front of your kmcp servers so that the agent-tool traffic is routed correctly through agentgateway. +## Installation profiles + +By default, kagent installs a `demo` profile with agents and MCP tools preloaded for you. If you don't want these default agents, you can disable them with the `minimal` profile. + +For the CLI: `kagent install --profile minimal` + +For Helm installations: Individually disable the default agents with Helm values or `--set` flags, such as `--set agents.argo-rollouts-agent.enabled=false`. You can also use Helm to update the resource limits and requests for each agent. + # v0.6 Review the main changes from kagent version 0.5 to v0.6, then continue reading for more detailed information. From d7a0f3b03b822f3a31a4d74a95b96c98f495bb2a Mon Sep 17 00:00:00 2001 From: Art Berger Date: Wed, 29 Oct 2025 17:56:30 -0400 Subject: [PATCH 4/4] revise local dev steps after testing Signed-off-by: Art Berger --- .../local-development/page.mdx | 46 ++++++++++++++++--- 1 file changed, 40 insertions(+), 6 deletions(-) diff --git a/src/app/docs/kagent/getting-started/local-development/page.mdx b/src/app/docs/kagent/getting-started/local-development/page.mdx index f525399..e820512 100644 --- a/src/app/docs/kagent/getting-started/local-development/page.mdx +++ b/src/app/docs/kagent/getting-started/local-development/page.mdx @@ -66,18 +66,23 @@ Before you run the agent, you must set the OpenAI API key as an environment vari export OPENAI_API_KEY= ``` +Then, let's change into the project directory. If you skip this step, just remember to add the project directory in each `kagent` command later, like `kagent build myagent`. + +```shell +cd myagent +``` + Let's build the agent: ```shell -kagent build myagent +kagent build ``` >Note the agent is automatically tagged with the `localhost:5001` registry, so make sure your Kubernetes cluster later on is configured to use this registry or push the image to a remote registry. -Now you can run the agent locally and test it out by running the following command from the `myagent` project directory: +Now you can run the agent locally and test it out by running the following command with the `myagent` project directory: ```shell -cd myagent kagent run ``` @@ -102,6 +107,11 @@ This command adds an entry to the `kagent.yaml` file and creates a new directory Whenever you add a new MCP server to the agent, the `docker-compose.yaml` file is updated to include the new MCP server. For example, after adding the above MCP server, the entry for it in the `docker-compose.yaml` file will look like this: +```bash +cat docker-compose.yaml +``` + +Example output: ```yaml server-everything: image: localhost:5001/myagent-server-everything:latest @@ -112,15 +122,39 @@ Whenever you add a new MCP server to the agent, the `docker-compose.yaml` file i - "3000" ``` -By default, all tools from the MCP server will be automatically available and added to the agent. You can also filter the tools by name or by using a predicate. For example, to only add the `add` tool, you can modify the `agent.py` file like this: +By default, all tools from the MCP server will be automatically available and added to the agent. You can also filter the tools by name or by using a predicate. + +The `mcp_tools.py` file is automatically generated when you add an MCP server that has the `get_mcp_tools` function. +The generated `agent.py` file already includes the import statement: ```python -mcp_tools = get_mcp_tools(server_filters={"server-everything": ["add"]}) +from .mcp_tools import get_mcp_tools ``` -This will only include the `add` tool from the `server-everything` MCP server. Let's rebuild the project using `kagent build` and then run the agent again using `kagent run`: +Open the `agent.py` file and find the line where `mcp_tools` is defined (usually near the bottom of the file) to filter specific tools. + +For example, to only add the `add` tool from the `server-everything` MCP server: +* Replace this line: + ```python + mcp_tools = get_mcp_tools() + ``` + +* with this line: + + ```python + mcp_tools = get_mcp_tools(server_filters={"server-everything": ["add"]}) + ``` + +This filter only includes the `add` tool from the `server-everything` MCP server. + +After updating your code, rebuild and run the project with + +``` +kagent build && kagent run +``` +Then repeat your question to check that the agent has access to the `add` tool. ```console You: what can you do?