Skip to content

Tools

On Routeplane, tools are the capabilities an agent picks up at runtime to get work done. They come in two kinds, and Routeplane serves both through one endpoint so an agent connects once instead of wiring up each source by hand:

  • MCP servers — callable tools (a search API, a database, a file system, a payment rail).
  • Agent Skills — loadable know-how: procedures and instructions an agent pulls in on demand.

An agent’s callable tools are MCP servers. Each exposes a set of tools an agent can discover and invoke. The catch is that those servers live in many places, each with its own address, auth, and endpoint — an agent that wants ten tool servers normally has to know about ten endpoints.

Routeplane’s MCP gateway sits in front of them and proxies them. Your agent connects to one Routeplane endpoint; behind it, the gateway forwards tool discovery and tool calls to the right upstream host and relays the responses back. One connection, many tool servers — mirroring how Routeplane treats models.

Routing tools through one gateway buys you three things you’d otherwise rebuild per agent:

  • Uniform auth — the agent authenticates once to Routeplane, instead of carrying credentials for every upstream server.
  • Discovery — tools across hosts surface in one place, so an agent finds what’s available without being pre-wired to each server.
  • Policy — every tool call passes through the gateway, the natural place to enforce rules consistently.

The gateway exposes a single aggregate endpoint that fans out across every configured server. A list call queries each server and returns the merged catalog; a tool call routes to the owning server. To keep names from colliding, each server’s tools are namespaced with a prefix — the search tool on the demo server is advertised as demo__search. A server can opt out of the aggregate to stay reachable only on its own route, and cheap list calls are cached briefly so discovery stays fast. The prefix and cache settings are configurable per server.

The second capability an agent acquires is know-how. Agent Skills are drop-in capabilities an agent loads on demand — a packaged procedure, a set of instructions, a workflow — discovered and pulled in the same way tools are, through the gateway. Where an MCP tool is something the agent calls, a Skill is something the agent learns: the knowledge travels with the agent instead of living in a human’s setup notes. One common Skill simply teaches an agent how to drive Routeplane itself.

  • Server tools — let Routeplane run the tool-calling loop for you, server-side.
  • Toolsets — how the tools advertised on a request are bundled and namespaced.