Xagent Docs
Get started

Custom APIs

Custom APIs let you turn any HTTP endpoint into a tool an agent can call. This is the bridge between Xagent and your internal systems — CRMs, databases behind a service, internal automation, or third-party APIs.

Registering a Custom API

Describe the endpoint — its URL, method, parameters, and authentication — and Xagent exposes it as a callable tool:

GET /api/custom-apis    # manage custom API tools

Each registered API becomes available to agents that are granted the matching tool category. The planner decides when to call it and supplies the arguments based on the task.

Authentication

Custom APIs can carry their own credentials (such as a bearer token or API key header) so the agent authenticates to your service without exposing secrets in prompts.

Trust boundary

A custom API gives agents the ability to call your services. Scope each registration to the minimum it needs, and prefer read-only endpoints unless write access is required.

Custom APIs vs. MCP

  • Use a custom API for a single endpoint you control and want to expose quickly.
  • Use an MCP server when a richer set of tools and resources is already packaged behind the protocol.

Next Steps