Skip to main content

MAD MCP API Documentation

Welcome to the MAD MCP aggregator docs.

The Portal exposes one secure MCP endpoint and a compact 12-tool Agent Contract that discovers and safely executes tools across the provider fleet.

Quick Start Guide

Get started in minutes:

  1. Create or sign in to your portal account.
  2. Configure one MCP integration in the Integrations tab.
  3. Generate broker credentials in Configurations.
  4. Call initialize, then use portal.find_tools and portal.get_tool_reference before the risk-matched executor.

Supported MCPs

Authentication

All broker requests require a MAD MCP bearer token:

Authorization: Bearer mad_live_***
Content-Type: application/json

Generate and rotate credentials in the portal.

Key Notes

  • Default discovery returns only agent_ready tools.
  • Fetch the lossless descriptor before constructing arguments.
  • Reads, writes, and destructive calls use separate executors.
  • Write and destructive calls require a matching preview token.
  • For heavy document ingestion in Qdrant, use source_url flows.