Praison AI

launch • AI Agent SDK

launch: Launch all agents as a single API endpoint (HTTP) or an MCP server.

launch

Method

</div>

This is a method of the AgentTeam class in the agents module.

Launch all agents as a single API endpoint (HTTP) or an MCP server. In HTTP mode, the endpoint accepts a query and processes it through all agents in sequence. In MCP mode, serving is delegated to the `praisonai-mcp agent adapter (serve_agents), publishing ask_&#123;agent_name&#125; per agent plus list_agents — the same path used by Agent.launch(protocol="mcp")`.

Signature

python
def launch(path: str, port: int, host: str, debug: bool, protocol: str) -> Any

Parameters

ParamField str

API endpoint path (default: ‘/agents’) for HTTP. Ignored in MCP mode.

ParamField int

Server port (default: 8000)

ParamField str

Server host (default: ‘127.0.0.1’; changed from ‘0.0.0.0’ to avoid binding all interfaces by default — pass ‘0.0.0.0’ explicitly to expose externally). Binding a non-loopback host without `PRAISONAI_LAUNCH_AUTH_TOKEN` set auto-generates and prints a one-time bearer token.

ParamField bool

Enable debug mode for uvicorn (default: False)

ParamField str

“http” to launch as FastAPI, “mcp” to serve over MCP via `praisonai-mcp (install with pip install praisonai-mcp`).

Returns

ResponseField Any

None

Uses

  • logging.warning
  • rstrip
  • display_error
  • logging.error
  • _server_registry.get_or_create_app
  • _server_registry.list_routes
  • uuid.uuid4
  • _server_registry.reserve_route
  • HTTPException
  • request.json

Source

View on GitHub

praisonaiagents/agents/agents.py at line 3686