diff --git a/public/images/agent-mcp-claude.png b/public/images/agent-mcp-claude.png new file mode 100644 index 00000000..387e9112 Binary files /dev/null and b/public/images/agent-mcp-claude.png differ diff --git a/public/images/agent-mcp-tools.png b/public/images/agent-mcp-tools.png new file mode 100644 index 00000000..34af50d2 Binary files /dev/null and b/public/images/agent-mcp-tools.png differ diff --git a/public/sitemap.xml b/public/sitemap.xml index 893b14b2..0f6d534c 100644 --- a/public/sitemap.xml +++ b/public/sitemap.xml @@ -2,749 +2,756 @@ https://kagent.dev/agents - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/blog - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/community - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/concepts/agents - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/concepts/architecture - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/concepts - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/concepts/tools - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/examples/a2a-agents - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/examples/a2a-byo - 2026-01-29 + 2026-02-05 + weekly + 0.8 + + + + https://kagent.dev/docs/kagent/examples/agents-mcp + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/examples/crewai-byo - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/examples/discord-a2a - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/examples/documentation - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/examples/langchain-byo - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/examples - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/examples/skills - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/examples/slack-a2a - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/getting-started/first-agent - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/getting-started/first-mcp-tool - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/getting-started/local-development - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/getting-started - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/getting-started/quickstart - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/getting-started/system-prompts - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/getting-started/tracing - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/introduction/installation - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/introduction - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/introduction/what-is-kagent - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/observability/audit-prompts - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/observability/launch-ui - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/observability - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/operations/debug - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/operations/operational-considerations - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/operations - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/operations/uninstall - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/operations/upgrade - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/resources/api-ref - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli/kagent-add-mcp - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli/kagent-bug-report - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli/kagent-build - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli/kagent-completion - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli/kagent-dashboard - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli/kagent-deploy - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli/kagent-get - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli/kagent-help - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli/kagent-init - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli/kagent-install - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli/kagent-invoke - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli/kagent-mcp - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli/kagent-run - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli/kagent-uninstall - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli/kagent-version - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/resources/cli - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/resources/faq - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/resources/helm - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/resources - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/resources/release-notes - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/supported-providers/amazon-bedrock - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/supported-providers/anthropic - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/supported-providers/azure-openai - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/supported-providers/byo-openai - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/supported-providers/gemini - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/supported-providers/google-vertexai - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/supported-providers/ollama - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/supported-providers/openai - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kagent/supported-providers - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kmcp/deploy/install-controller - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kmcp/deploy - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kmcp/deploy/server - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kmcp/develop/fastmcp-python - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kmcp/develop/mcp-go - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kmcp/develop - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kmcp/introduction - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kmcp - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kmcp/quickstart - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kmcp/reference/api-ref - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kmcp/reference/kmcp-add-tool - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kmcp/reference/kmcp-build - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kmcp/reference/kmcp-completion - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kmcp/reference/kmcp-deploy - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kmcp/reference/kmcp-help - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kmcp/reference/kmcp-init - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kmcp/reference/kmcp-install - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kmcp/reference/kmcp-run - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kmcp/reference/kmcp-secrets - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kmcp/reference - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs/kmcp/secrets - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/docs - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/enterprise - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/page.tsx - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/tools - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/agents/argo-rollouts-conversion-agent - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/agents/cilium-crd-agent - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/agents/helm-agent - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/agents/istio-agent - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/agents/k8s-agent - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/agents/kgateway-agent - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/agents/observability-agent - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/agents/promql-agent - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/tools/istio - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/tools/kubernetes - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/tools/prometheus - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/tools/documentation - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/tools/helm - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/tools/argo - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/tools/grafana - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/tools/other - 2026-01-29 + 2026-02-05 weekly 0.8 https://kagent.dev/tools/cilium - 2026-01-29 + 2026-02-05 weekly 0.8 diff --git a/src/app/docs/kagent/examples/agents-mcp/page.mdx b/src/app/docs/kagent/examples/agents-mcp/page.mdx new file mode 100644 index 00000000..94bb6dd6 --- /dev/null +++ b/src/app/docs/kagent/examples/agents-mcp/page.mdx @@ -0,0 +1,81 @@ +--- +title: "Using Kagent agents via MCP" +pageOrder: 1 +description: "Connect external clients like Cursor and Claude to interact with Kagent agents using the Model Context Protocol." +--- + +export const metadata = { + title: "Using Kagent agents via MCP", + description: + "Connect external clients like Cursor and Claude to interact with Kagent agents using the Model Context Protocol.", + author: "kagent.dev", +}; + +# Using Kagent agents via MCP + +Kagent exposes all running agents via a Model Context Protocol (MCP) server embedded in the control plane HTTP server. This allows you to interact with your Kagent agents using any MCP-compliant client at `http:///mcp`. + +## Setting up + +Connect your MCP client to the Kagent MCP endpoint using the Streamable HTTP transport. + +### Local Development + +If you are running Kagent locally, you can port-forward the control plane service: + +```bash +kubectl port-forward -n kagent svc/kagent-controller 8083:8083 +``` + +Then use `http://localhost:8080/mcp` as your MCP endpoint. Otherwise, use the IP address of your kagent control plane. + +### Example: Cursor Configuration + +Add the following to your Cursor MCP settings: + +```json +{ + "mcpServers": { + "kagent-agents": { + "url": "http://localhost:8083/mcp" + } + } +} +``` + +_Note: Ensure the port matches your local setup (e.g., 8083)._ + +### Example: Claude Code + +To add Kagent to Claude Code: + +```bash +claude mcp add --transport http kagent http://localhost:8083/mcp +``` + +Add `--scope project` to limit the configuration to the current project. + +> SSE (Server-Sent Events) is currently not supported. You must use Streamable HTTP. Future updates will include stdio support via the CLI. + +## Using the MCP Server + +The MCP server exposes two core tools: + +1. `list_agents`: Lists all available agents. +2. `invoke_agent`: Runs a specific agent by name with a given input. Supports `sessionID` for continuing conversations. + +This architecture enables MCP clients (like Cursor or other agents) to discover and orchestrate Kagent agents as "sub-agents," delegating specialized tasks or cluster actions securely. + +### Tools Overview + +![List Tools](/images/agent-mcp-tools.png "List tools") + +### Example Usage + +Here is an example of asking Claude about a Kubernetes cluster: + +![Ask Claude](/images/agent-mcp-claude.png "Ask Claude") + +In this workflow, the client first calls `list_agents` to discover capabilities, then calls `invoke_agent` to execute the `k8s-agent` with the user's query. + +Try it out and see what you can do! Feel free to open issues for feedback or suggestions. diff --git a/src/components/hackathon-banner.tsx b/src/components/hackathon-banner.tsx index e4ad47fc..e1ef543c 100644 --- a/src/components/hackathon-banner.tsx +++ b/src/components/hackathon-banner.tsx @@ -94,7 +94,7 @@ export default function HackathonBanner() { className="text-[10px] uppercase tracking-[0.3em] mb-2" style={{ color: 'rgba(0, 255, 255, 0.6)' }} > - // Virtual Hackathon + {"//"} Virtual Hackathon