mcp-integration

Load MCP-exposed tools into orxhestra agents via MCPClient and MCPToolAdapter.

19|6|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/NicolaiLassen/orxhestra --skill mcp-integration-nicolailassen
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mcp-integration
Source: https://github.com/NicolaiLassen/orxhestra/tree/main/docs/skills/mcp-integration
Command: npx skills add https://github.com/NicolaiLassen/orxhestra --skill mcp-integration-nicolailassen

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the challenge of wiring orxhestra agents to external tool servers by providing a consistent way to fetch and use MCP-exposed capabilities.

Core Features & Use Cases

  • MCP client + tool adapter: Uses MCPClient and MCPToolAdapter to retrieve the MCP tool list and expose each tool to an agent.
  • HTTP and in-memory support: Works with an MCP server over an HTTP endpoint or directly with a FastMCP in-memory server object.
  • YAML Composer integration: Enables configuring MCP tool servers directly in YAML under the agent’s tools section.
  • Use case: When you have an existing MCP tool server that wraps company-specific utilities, you can connect it to an orxhestra agent so the agent can call those tools to answer questions and perform actions.

Quick Start

Install the MCP extras, then create an MCPClient pointing at your MCP server, load tools via MCPToolAdapter, and pass the resulting tools into your LlmAgent so it can call the MCP tools.

Frequently Asked Questions about mcp-integration

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I connect MCP tools to a multi-agent system for tool orchestration?

To connect MCP tools to a multi-agent system, use an MCPClient and MCPToolAdapter to asynchronously load the tool list from your HTTP or in-memory FastMCP server, then pass the adapted tools to your LlmAgent as its toolset for execution.

Can I use a FastMCP in-memory server directly with an agent without HTTP?

Yes, you can use a FastMCP in-memory server directly with an agent. The integration supports both HTTP endpoints and in-memory FastMCP server objects, allowing you to load tools via MCPToolAdapter without needing a remote network connection.

What is the best way to configure MCP tool servers in YAML for agent orchestration?

The best way to configure MCP tool servers in YAML is by defining them directly under the agent's tools section. This YAML Composer integration enables seamless tool loading and agent orchestration without requiring manual client initialization in your code.

Does this MCP integration work with both HTTP endpoints and in-memory servers?

Yes, this MCP integration works with both HTTP endpoints and in-memory FastMCP servers. You can initialize the MCPClient to target either an external HTTP endpoint or a local in-memory server object to retrieve and adapt tools for your agents.

Why do I need an MCPToolAdapter to wire external tools to my agents?

You need an MCPToolAdapter to wire external tools to your agents because it fetches the MCP-exposed capabilities from the server and adapts them into a format that the LlmAgent can natively execute for question answering and automation workflows.

When should I use an MCP tool adapter instead of direct tool integration?

You should use an MCP tool adapter instead of direct integration when your company-specific utilities are hosted externally via an MCP server. It provides a consistent way to fetch and use MCP-exposed capabilities without manually wrapping each external tool.