asqav-mcp

Instructions

Implementation Reference

• src/asqav_mcp/server.py:96-111 (handler)

  The list_agents tool handler, which uses FastMCP decorator to register the tool and fetches agents from the API.

  @mcp.tool()
  async def list_agents() -> str:
      """List all registered AI agents in the organization."""
      try:
          agents = await _request("GET", "/agents")
          if not agents:
              return "No agents registered."
          lines = []
          for a in agents:
              status = a.get("status", "unknown")
              name = a.get("name", "unnamed")
              aid = a.get("agent_id", "?")
              lines.append(f"- {name} ({aid}) [{status}]")
          return "\n".join(lines)
      except Exception as e:
          return f"Error listing agents: {e}"