get_owner_ecosystems
Find wallet addresses that operate multiple connected agents. Identifies ecosystems where a single owner has at least two named agents with relationships, enabling discovery of multi-agent teams.
Instructions
Return owners who operate multiple connected agents.
An "ecosystem" is a single wallet address with 2+ named agents that have at least one relationship. Useful for finding multi-agent teams.
Args: limit: Maximum number of ecosystems to return (default 10).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- src/minuet_mcp/server.py:86-99 (handler)Handler function for the 'get_owner_ecosystems' tool. Decorated with @mcp.tool(), it creates a MinuetClient, calls client.get_clusters(), extracts the 'ecosystems' key from the response (applying the limit), and returns a dict with count and ecosystems list.
@mcp.tool() async def get_owner_ecosystems(limit: int = 10) -> dict[str, Any]: """Return owners who operate multiple connected agents. An "ecosystem" is a single wallet address with 2+ named agents that have at least one relationship. Useful for finding multi-agent teams. Args: limit: Maximum number of ecosystems to return (default 10). """ async with MinuetClient() as client: data = await client.get_clusters() ecosystems = data.get("ecosystems", [])[:limit] return {"count": len(ecosystems), "ecosystems": ecosystems} - src/minuet_mcp/server.py:86-86 (registration)The tool is registered via the @mcp.tool() decorator on line 86, which registers 'get_owner_ecosystems' as an MCP tool with the FastMCP server instance 'mcp' (defined on line 16).
@mcp.tool() - src/minuet_mcp/client.py:102-103 (helper)Helper method 'get_clusters' on MinuetClient. This is the underlying API call used by get_owner_ecosystems — it hits GET /api/relationships/clusters and returns the JSON response containing both 'hubs' and 'ecosystems' data.
async def get_clusters(self) -> dict[str, Any]: return await self._get("/api/relationships/clusters")