QuantConnect MCP Server

Instructions

Implementation Reference

• quantconnect_mcp/src/tools/auth_tools.py:58-95 (handler)

  The main execution handler for the 'validate_quantconnect_auth' tool. Retrieves the current authentication instance using get_auth_instance(), validates it via auth.validate_authentication(), and returns a dictionary with validation status, message, and auth details.

  @mcp.tool()
  async def validate_quantconnect_auth() -> Dict[str, Any]:
      """
      Validate current QuantConnect authentication configuration.
  
      Returns:
          Dictionary containing authentication validation results
      """
      try:
          auth = get_auth_instance()
  
          if auth is None:
              return {
                  "status": "error",
                  "error": "Authentication not configured",
                  "message": "Use configure_quantconnect_auth to set up credentials first",
                  "authenticated": False,
              }
  
          # Validate authentication
          is_valid, message = await auth.validate_authentication()
  
          return {
              "status": "success" if is_valid else "error",
              "authenticated": is_valid,
              "message": message,
              "user_id": auth.user_id,
              "organization_id": auth.organization_id,
              "has_organization": auth.organization_id is not None,
          }
  
      except Exception as e:
          return {
              "status": "error",
              "error": str(e),
              "message": "Failed to validate authentication",
              "authenticated": False,
          }

• quantconnect_mcp/src/server.py:73-79 (registration)

  Registration block where register_auth_tools(mcp) is called, which defines and registers the 'validate_quantconnect_auth' tool using FastMCP's @mcp.tool() decorator.

  safe_print("🔧 Registering QuantConnect tools...")
  register_auth_tools(mcp)
  register_project_tools(mcp)
  register_file_tools(mcp)
  register_backtest_tools(mcp)
  register_live_tools(mcp)
  register_optimization_tools(mcp)

• quantconnect_mcp/main.py:46-52 (registration)

  Alternative entrypoint registration block where register_auth_tools(mcp) is called to register the auth tools including 'validate_quantconnect_auth'.

  safe_print("🔧 Registering QuantConnect tools...")
  register_auth_tools(mcp)
  register_project_tools(mcp)
  register_file_tools(mcp)
  register_backtest_tools(mcp)
  register_live_tools(mcp)
  register_optimization_tools(mcp)