selenium-mcp

{
  "name": "io.github.pshivapr/selenium-mcp",
  "tags": [
    "selenium",
    "webdriver",
    "selenium-webdriver",
    "mcp",
    "modelcontextprotocol",
    "automation"
  ],
  "tools": [
    {
      "name": "browser_hover",
      "description": "Hover over an element",
      "input_schema": {
        "type": "object",
        "required": [
          "by",
          "value"
        ],
        "properties": {
          "by": {
            "type": "string"
          },
          "value": {
            "type": "string"
          },
          "timeout": {
            "type": "number"
          }
        }
      },
      "output_schema": {
        "content": [
          {
            "text": "Hovered over element",
            "type": "text"
          }
        ]
      }
    },
    {
      "name": "browser_wait_for_element",
      "description": "Wait for an element to be present",
      "input_schema": {
        "type": "object",
        "required": [
          "by",
          "value"
        ],
        "properties": {
          "by": {
            "type": "string"
          },
          "value": {
            "type": "string"
          },
          "timeout": {
            "type": "number"
          }
        }
      },
      "output_schema": {
        "content": [
          {
            "text": "Waited for element: {value}",
            "type": "text"
          }
        ]
      }
    },
    {
      "name": "browser_drag_and_drop",
      "description": "Perform drag and drop between two elements",
      "input_schema": {
        "type": "object",
        "required": [
          "by",
          "value",
          "targetBy",
          "targetValue"
        ],
        "properties": {
          "by": {
            "type": "string"
          },
          "value": {
            "type": "string"
          },
          "timeout": {
            "type": "number"
          },
          "targetBy": {
            "type": "string"
          },
          "targetValue": {
            "type": "string"
          }
        }
      },
      "output_schema": {
        "content": [
          {
            "text": "Drag and drop completed",
            "type": "text"
          }
        ]
      }
    },
    {
      "name": "browser_double_click",
      "description": "Perform double click on an element",
      "input_schema": {
        "type": "object",
        "required": [
          "by",
          "value"
        ],
        "properties": {
          "by": {
            "type": "string"
          },
          "value": {
            "type": "string"
          },
          "timeout": {
            "type": "number"
          }
        }
      },
      "output_schema": {
        "content": [
          {
            "text": "Double click performed",
            "type": "text"
          }
        ]
      }
    },
    {
      "name": "browser_right_click",
      "description": "Perform right click (context click) on an element",
      "input_schema": {
        "type": "object",
        "required": [
          "by",
          "value"
        ],
        "properties": {
          "by": {
            "type": "string"
          },
          "value": {
            "type": "string"
          },
          "timeout": {
            "type": "number"
          }
        }
      },
      "output_schema": {
        "content": [
          {
            "text": "Right click performed",
            "type": "text"
          }
        ]
      }
    },
    {
      "name": "browser_select_dropdown_by_text",
      "description": "Select dropdown by visible text",
      "input_schema": {
        "type": "object",
        "required": [
          "by",
          "value",
          "text"
        ],
        "properties": {
          "by": {
            "type": "string"
          },
          "text": {
            "type": "string"
          },
          "value": {
            "type": "string"
          },
          "timeout": {
            "type": "number"
          }
        }
      },
      "output_schema": {
        "content": [
          {
            "text": "Selected dropdown option by text: {text}",
            "type": "text"
          }
        ]
      }
    },
    {
      "name": "browser_select_dropdown_by_value",
      "description": "Select dropdown by value",
      "input_schema": {
        "type": "object",
        "required": [
          "by",
          "value"
        ],
        "properties": {
          "by": {
            "type": "string"
          },
          "value": {
            "type": "string"
          },
          "timeout": {
            "type": "number"
          }
        }
      },
      "output_schema": {
        "content": [
          {
            "text": "Selected dropdown option by value: {value}",
            "type": "text"
          }
        ]
      }
    },
    {
      "name": "browser_key_press",
      "description": "Press a key on the keyboard",
      "input_schema": {
        "type": "object",
        "required": [
          "key"
        ],
        "properties": {
          "key": {
            "type": "string"
          }
        }
      },
      "output_schema": {
        "content": [
          {
            "text": "Key '{key}' pressed",
            "type": "text"
          }
        ]
      }
    },
    {
      "name": "browser_execute_script",
      "description": "Execute JavaScript in the context of the current page",
      "input_schema": {
        "type": "object",
        "required": [
          "script"
        ],
        "properties": {
          "script": {
            "type": "string"
          }
        }
      },
      "output_schema": {
        "content": [
          {
            "text": "Script executed successfully: {result}",
            "type": "text"
          }
        ]
      }
    },
    {
      "name": "browser_scroll_to_element",
      "description": "Scroll to an element",
      "input_schema": {
        "type": "object",
        "required": [
          "by",
          "value"
        ],
        "properties": {
          "by": {
            "type": "string"
          },
          "value": {
            "type": "string"
          },
          "timeout": {
            "type": "number"
          }
        }
      },
      "output_schema": {
        "content": [
          {
            "text": "Scrolled to element",
            "type": "text"
          }
        ]
      }
    },
    {
      "name": "browser_scroll_to_top",
      "description": "Scroll to the top of the page",
      "input_schema": {
        "type": "object",
        "required": [],
        "properties": {}
      },
      "output_schema": {
        "content": [
          {
            "text": "Scrolled to top of the page",
            "type": "text"
          }
        ]
      }
    },
    {
      "name": "browser_scroll_to_bottom",
      "description": "Scroll to the bottom of the page",
      "input_schema": {
        "type": "object",
        "required": [],
        "properties": {}
      },
      "output_schema": {
        "content": [
          {
            "text": "Scrolled to bottom of the page",
            "type": "text"
          }
        ]
      }
    },
    {
      "name": "browser_scroll_to_coordinates",
      "description": "Scroll to specific coordinates",
      "input_schema": {
        "type": "object",
        "required": [
          "x",
          "y"
        ],
        "properties": {
          "x": {
            "type": "number"
          },
          "y": {
            "type": "number"
          }
        }
      },
      "output_schema": {
        "content": [
          {
            "text": "Scrolled to coordinates ({x}, {y})",
            "type": "text"
          }
        ]
      }
    },
    {
      "name": "browser_scroll_by_pixels",
      "description": "Scroll by a specific number of pixels",
      "input_schema": {
        "type": "object",
        "required": [
          "x",
          "y"
        ],
        "properties": {
          "x": {
            "type": "number"
          },
          "y": {
            "type": "number"
          }
        }
      },
      "output_schema": {
        "content": [
          {
            "text": "Scrolled by pixels ({x}, {y})",
            "type": "text"
          }
        ]
      }
    },
    {
      "name": "browser_select_checkbox",
      "description": "Select a checkbox",
      "input_schema": {
        "type": "object",
        "required": [
          "by",
          "value"
        ],
        "properties": {
          "by": {
            "type": "string"
          },
          "value": {
            "type": "string"
          }
        }
      },
      "output_schema": {
        "content": [
          {
            "text": "Selected checkbox",
            "type": "text"
          }
        ]
      }
    },
    {
      "name": "browser_unselect_checkbox",
      "description": "Unselect a checkbox",
      "input_schema": {
        "type": "object",
        "required": [
          "by",
          "value"
        ],
        "properties": {
          "by": {
            "type": "string"
          },
          "value": {
            "type": "string"
          }
        }
      },
      "output_schema": {
        "content": [
          {
            "text": "Unselected checkbox",
            "type": "text"
          }
        ]
      }
    },
    {
      "name": "browser_submit_form",
      "description": "Submit a form",
      "input_schema": {
        "type": "object",
        "required": [
          "by",
          "value"
        ],
        "properties": {
          "by": {
            "type": "string"
          },
          "value": {
            "type": "string"
          }
        }
      },
      "output_schema": {
        "content": [
          {
            "text": "Submitted form",
            "type": "text"
          }
        ]
      }
    },
    {
      "name": "browser_focus_element",
      "description": "Focus on a specific element",
      "input_schema": {
        "type": "object",
        "required": [
          "by",
          "value"
        ],
        "properties": {
          "by": {
            "type": "string"
          },
          "value": {
            "type": "string"
          }
        }
      },
      "output_schema": {
        "content": [
          {
            "text": "Focused on element",
            "type": "text"
          }
        ]
      }
    },
    {
      "name": "browser_blur_element",
      "description": "Remove focus from a specific element",
      "input_schema": {
        "type": "object",
        "required": [
          "by",
          "value"
        ],
        "properties": {
          "by": {
            "type": "string"
          },
          "value": {
            "type": "string"
          }
        }
      },
      "output_schema": {
        "content": [
          {
            "text": "Removed focus from element",
            "type": "text"
          }
        ]
      }
    },
    {
      "name": "browser_screenshot",
      "description": "Take a screenshot of the current page",
      "input_schema": {
        "type": "object",
        "required": [],
        "properties": {
          "outputPath": {
            "type": "string"
          }
        }
      },
      "output_schema": {
        "content": [
          {
            "text": "Screenshot saved to {outputPath}",
            "type": "text"
          },
          {
            "text": "Screenshot captured as base64:",
            "type": "text"
          }
        ]
      }
    },
    {
      "name": "browser_open",
      "description": "Open a new browser session",
      "input_schema": {
        "type": "object",
        "required": [
          "browser"
        ],
        "properties": {
          "browser": {
            "type": "string"
          },
          "options": {
            "type": "object"
          }
        }
      },
      "output_schema": {
        "content": [
          {
            "text": "Browser started with session_id: {sessionId}",
            "type": "text"
          }
        ]
      }
    },
    {
      "name": "browser_navigate",
      "description": "Navigate to a URL",
      "input_schema": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string"
          }
        }
      },
      "output_schema": {
        "content": [
          {
            "text": "Navigated to {url}",
            "type": "text"
          }
        ]
      }
    },
    {
      "name": "browser_navigate_back",
      "description": "Navigate back in the browser",
      "input_schema": {
        "type": "object",
        "required": [],
        "properties": {}
      },
      "output_schema": {
        "content": [
          {
            "text": "Navigated back",
            "type": "text"
          }
        ]
      }
    },
    {
      "name": "browser_navigate_forward",
      "description": "Navigate forward in the browser",
      "input_schema": {
        "type": "object",
        "required": [],
        "properties": {}
      },
      "output_schema": {
        "content": [
          {
            "text": "Navigated forward",
            "type": "text"
          }
        ]
      }
    },
    {
      "name": "browser_title",
      "description": "Get the current page title",
      "input_schema": {
        "type": "object",
        "required": [],
        "properties": {}
      },
      "output_schema": {
        "content": [
          {
            "text": "Current page title is: {title}",
            "type": "text"
          }
        ]
      }
    },
    {
      "name": "browser_get_url",
      "description": "Get the current page URL",
      "input_schema": {
        "type": "object",
        "required": [],
        "properties": {}
      },
      "output_schema": {
        "content": [
          {
            "text": "Current page URL is: {url}",
            "type": "text"
          }
        ]
      }
    },
    {
      "name": "browser_get_page_source",
      "description": "Get the current page source",
      "input_schema": {
        "type": "object",
        "required": [],
        "properties": {}
      },
      "output_schema": {
        "content": [
          {
            "text": "Current page source is: {pageSource}",
            "type": "text"
          }
        ]
      }
    },
    {
      "name": "browser_maximize",
      "description": "Maximize the browser window",
      "input_schema": {
        "type": "object",
        "required": [],
        "properties": {}
      },
      "output_schema": {
        "content": [
          {
            "text": "Browser window maximised",
            "type": "text"
          }
        ]
      }
    },
    {
      "name": "browser_resize",
      "description": "Resize the browser window",
      "input_schema": {
        "type": "object",
        "required": [
          "width",
          "height"
        ],
        "properties": {
          "width": {
            "type": "number"
          },
          "height": {
            "type": "number"
          }
        }
      },
      "output_schema": {
        "content": [
          {
            "text": "Browser window resized to {width}x{height}",
            "type": "text"
          }
        ]
      }
    },
    {
      "name": "browser_refresh",
      "description": "Refresh the current page",
      "input_schema": {
        "type": "object",
        "required": [],
        "properties": {}
      },
      "output_schema": {
        "content": [
          {
            "text": "Browser refreshed",
            "type": "text"
          }
        ]
      }
    },
    {
      "name": "browser_switch_to_window",
      "description": "Switch to a different browser window",
      "input_schema": {
        "type": "object",
        "required": [
          "windowHandle"
        ],
        "properties": {
          "windowHandle": {
            "type": "string"
          }
        }
      },
      "output_schema": {
        "content": [
          {
            "text": "Switched to window: {windowHandle}",
            "type": "text"
          }
        ]
      }
    },
    {
      "name": "browser_switch_to_original_window",
      "description": "Switches back to the original browser window",
      "input_schema": {
        "type": "object",
        "required": [],
        "properties": {}
      },
      "output_schema": {
        "content": [
          {
            "text": "Switched to original window",
            "type": "text"
          }
        ]
      }
    },
    {
      "name": "browser_switch_to_window_by_title",
      "description": "Switch to a window by its title",
      "input_schema": {
        "type": "object",
        "required": [
          "title"
        ],
        "properties": {
          "title": {
            "type": "string"
          }
        }
      },
      "output_schema": {
        "content": [
          {
            "text": "Switched to window: {title}",
            "type": "text"
          }
        ]
      }
    },
    {
      "name": "browser_switch_window_by_index",
      "description": "Switch to a window by its index",
      "input_schema": {
        "type": "object",
        "required": [
          "index"
        ],
        "properties": {
          "index": {
            "type": "number"
          }
        }
      },
      "output_schema": {
        "content": [
          {
            "text": "Switched to window at index: {index}",
            "type": "text"
          }
        ]
      }
    },
    {
      "name": "browser_switch_to_window_by_url",
      "description": "Switch to a window by its URL",
      "input_schema": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string"
          }
        }
      },
      "output_schema": {
        "content": [
          {
            "text": "Switched to window: {url}",
            "type": "text"
          }
        ]
      }
    },
    {
      "name": "browser_close",
      "description": "Close the current browser session",
      "input_schema": {
        "type": "object",
        "required": [],
        "properties": {}
      },
      "output_schema": {
        "content": [
          {
            "text": "Browser session {sessionId} closed",
            "type": "text"
          }
        ]
      }
    },
    {
      "name": "browser_get_cookies",
      "description": "Get all cookies",
      "input_schema": {
        "type": "object",
        "required": [],
        "properties": {}
      },
      "output_schema": {
        "content": [
          {
            "text": "Cookies: {cookies}",
            "type": "text"
          }
        ]
      }
    },
    {
      "name": "browser_get_cookie_by_name",
      "description": "Get a cookie by name",
      "input_schema": {
        "type": "object",
        "required": [
          "name"
        ],
        "properties": {
          "name": {
            "type": "string"
          }
        }
      },
      "output_schema": {
        "content": [
          {
            "text": "Cookie: {cookieValue}",
            "type": "text"
          }
        ]
      }
    },
    {
      "name": "browser_add_cookie_by_name",
      "description": "Add a cookie to the browser",
      "input_schema": {
        "type": "object",
        "required": [
          "name",
          "value"
        ],
        "properties": {
          "name": {
            "type": "string"
          },
          "value": {
            "type": "string"
          }
        }
      },
      "output_schema": {
        "content": [
          {
            "text": "Added cookie: {name}",
            "type": "text"
          }
        ]
      }
    },
    {
      "name": "browser_set_cookie_object",
      "description": "Set a cookie in the browser",
      "input_schema": {
        "type": "object",
        "required": [
          "cookie"
        ],
        "properties": {
          "cookie": {
            "type": "string"
          }
        }
      },
      "output_schema": {
        "content": [
          {
            "text": "Set cookie: {cookie}",
            "type": "text"
          }
        ]
      }
    },
    {
      "name": "browser_delete_cookie",
      "description": "Delete a cookie from the browser",
      "input_schema": {
        "type": "object",
        "required": [
          "name"
        ],
        "properties": {
          "name": {
            "type": "string"
          }
        }
      },
      "output_schema": {
        "content": [
          {
            "text": "Deleted cookie: {name}",
            "type": "text"
          }
        ]
      }
    },
    {
      "name": "browser_delete_cookies",
      "description": "Delete cookies from the browser",
      "input_schema": {
        "type": "object",
        "required": [],
        "properties": {}
      },
      "output_schema": {
        "content": [
          {
            "text": "Deleted all cookies",
            "type": "text"
          }
        ]
      }
    },
    {
      "name": "browser_find_element",
      "description": "Find an element",
      "input_schema": {
        "type": "object",
        "required": [
          "by",
          "value"
        ],
        "properties": {
          "by": {
            "type": "string"
          },
          "value": {
            "type": "string"
          },
          "timeout": {
            "type": "number"
          }
        }
      },
      "output_schema": {
        "content": [
          {
            "text": "Element found",
            "type": "text"
          }
        ]
      }
    },
    {
      "name": "browser_find_elements",
      "description": "Find multiple elements",
      "input_schema": {
        "type": "object",
        "required": [
          "by",
          "value"
        ],
        "properties": {
          "by": {
            "type": "string"
          },
          "value": {
            "type": "string"
          },
          "timeout": {
            "type": "number"
          }
        }
      },
      "output_schema": {
        "content": [
          {
            "text": "Found {elements.length} elements",
            "type": "text"
          }
        ]
      }
    },
    {
      "name": "browser_click",
      "description": "Perform a click on an element",
      "input_schema": {
        "type": "object",
        "required": [
          "by",
          "value"
        ],
        "properties": {
          "by": {
            "type": "string"
          },
          "value": {
            "type": "string"
          },
          "timeout": {
            "type": "number"
          }
        }
      },
      "output_schema": {
        "content": [
          {
            "text": "Element clicked",
            "type": "text"
          }
        ]
      }
    },
    {
      "name": "browser_type",
      "description": "Type into an editable field",
      "input_schema": {
        "type": "object",
        "required": [
          "by",
          "value",
          "text"
        ],
        "properties": {
          "by": {
            "type": "string"
          },
          "text": {
            "type": "string"
          },
          "value": {
            "type": "string"
          },
          "timeout": {
            "type": "number"
          }
        }
      },
      "output_schema": {
        "content": [
          {
            "text": "Text \"{text}\" entered into element",
            "type": "text"
          }
        ]
      }
    },
    {
      "name": "browser_clear",
      "description": "Clears the value of an input element",
      "input_schema": {
        "type": "object",
        "required": [
          "by",
          "value"
        ],
        "properties": {
          "by": {
            "type": "string"
          },
          "value": {
            "type": "string"
          },
          "timeout": {
            "type": "number"
          }
        }
      },
      "output_schema": {
        "content": [
          {
            "text": "Element cleared",
            "type": "text"
          }
        ]
      }
    },
    {
      "name": "browser_get_element_text",
      "description": "Gets the text of an element",
      "input_schema": {
        "type": "object",
        "required": [
          "by",
          "value"
        ],
        "properties": {
          "by": {
            "type": "string"
          },
          "value": {
            "type": "string"
          },
          "timeout": {
            "type": "number"
          }
        }
      },
      "output_schema": {
        "content": [
          {
            "text": "{text}",
            "type": "text"
          }
        ]
      }
    },
    {
      "name": "browser_get_attribute",
      "description": "Gets the value of an attribute from an element",
      "input_schema": {
        "type": "object",
        "required": [
          "by",
          "value",
          "attribute"
        ],
        "properties": {
          "by": {
            "type": "string"
          },
          "value": {
            "type": "string"
          },
          "timeout": {
            "type": "number"
          },
          "attribute": {
            "type": "string"
          }
        }
      },
      "output_schema": {
        "content": [
          {
            "text": "Attribute \"{attribute}\" has value: {attrValue}",
            "type": "text"
          }
        ]
      }
    },
    {
      "name": "browser_element_is_displayed",
      "description": "Checks if an element is displayed",
      "input_schema": {
        "type": "object",
        "required": [
          "by",
          "value"
        ],
        "properties": {
          "by": {
            "type": "string"
          },
          "value": {
            "type": "string"
          },
          "timeout": {
            "type": "number"
          }
        }
      },
      "output_schema": {
        "content": [
          {
            "text": "Element is displayed: {isDisplayed}",
            "type": "text"
          }
        ]
      }
    }
  ],
  "version": "0.4.1",
  "categories": [],
  "description": "Selenium Tools for MCP"
}

Forks