DrissionPage MCP Server

Overview Schema Source Related Servers Discussions Admin

Navigate to URL

page_navigate

Destructive

Navigate the browser to a specified URL, optionally opening it in a new tab, window, or disposable context. Use it to move automation from the current page to a target web address.

Instructions

Navigate to a specific URL in the browser

Input Schema

TableJSON Schema

Name	Required	Description
`url`	Yes	The URL to navigate to
`tab_id`	No	Optional MCP or native DrissionPage tab id. When omitted, the current tab is captured at call start.
`new_tab`	No	Open the URL in a new browser tab instead of the current tab.
`observe`	No	Return a compact before/after page change summary.
`background`	No	Create the requested new tab in the background without changing the MCP current tab. Requires new_tab=true.
`new_window`	No	Open the requested new tab in a separate window. Requires new_tab=true.
`new_context`	No	Create the requested new tab in a disposable Chromium browser context. Closing the tab disposes that context. Requires new_tab=true.

Output Schema

TableJSON Schema

Name	Required	Description	Default
No arguments

Schema Changelog

Changes observed during successful MCP inspections.

Changed5 schema fields changedv0.8.8Sep 13, 2026

addedInput schema / properties / background

Added value: +{
+  "default": false,
+  "description": "Create the requested new tab in the background without changing the MCP current tab. Requires new_tab=true.",
+  "title": "Background",
+  "type": "boolean"
+}

addedInput schema / properties / new_context

Added value: +{
+  "default": false,
+  "description": "Create the requested new tab in a disposable Chromium browser context. Closing the tab disposes that context. Requires new_tab=true.",
+  "title": "New Context",
+  "type": "boolean"
+}

addedInput schema / properties / new_window

Added value: +{
+  "default": false,
+  "description": "Open the requested new tab in a separate window. Requires new_tab=true.",
+  "title": "New Window",
+  "type": "boolean"
+}

addedInput schema / properties / tab_id

Added value: +{
+  "anyOf": [
+    {
+      "maxLength": 128,
+      "minLength": 1,
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Optional MCP or native DrissionPage tab id. When omitted, the current tab is captured at call start.",
+  "title": "Tab Id"
+}

changedOutput schema / oneOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "data": {
-        "additionalProperties": false,
-        "properties": {
-          "changes": {
-            "anyOf": [
-              {
-                "additionalProperties": true,
-                "type": "object"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "default": null,
-            "title": "Changes"
-          },
-          "final_url": {
-            "title": "Final Url",
-            "type": "string"
-          },
-          "new_tab": {
-            "title": "New Tab",
-            "type": "boolean"
-          },
-          "tab_id": {
-            "title": "Tab Id",
-            "type": "string"
-          },
-          "url": {
-            "title": "Url",
-            "type": "string"
-          }
-        },
-        "required": [
-          "url",
-          "final_url",
-          "new_tab",
-          "tab_id"
-        ],
-        "title": "PageNavigateData",
-        "type": "object"
-      },
-      "message": {
-        "type": "string"
-      },
-      "ok": {
-        "const": true
-      }
-    },
-    "required": [
-      "ok",
-      "message",
-      "data"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "data": {
-        "additionalProperties": true,
-        "type": "object"
-      },
-      "error": {
-        "additionalProperties": false,
-        "properties": {
-          "code": {
-            "type": "string"
-          },
-          "details": {
-            "additionalProperties": true,
-            "type": "object"
-          },
-          "message": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "code",
-          "message"
-        ],
-        "type": "object"
-      },
-      "message": {
-        "type": "string"
-      },
-      "ok": {
-        "const": false
-      }
-    },
-    "required": [
-      "ok",
-      "message",
-      "error"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "data": {
+        "additionalProperties": false,
+        "properties": {
+          "active": {
+            "default": true,
+            "title": "Active",
+            "type": "boolean"
+          },
+          "background": {
+            "default": false,
+            "title": "Background",
+            "type": "boolean"
+          },
+          "changes": {
+            "anyOf": [
+              {
+                "additionalProperties": true,
+                "type": "object"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "title": "Changes"
+          },
+          "final_url": {
+            "title": "Final Url",
+            "type": "string"
+          },
+          "new_context": {
+            "default": false,
+            "title": "New Context",
+            "type": "boolean"
+          },
+          "new_tab": {
+            "title": "New Tab",
+            "type": "boolean"
+          },
+          "new_window": {
+            "default": false,
+            "title": "New Window",
+            "type": "boolean"
+          },
+          "tab_id": {
+            "description": "MCP tab id captured for this operation.",
+            "maxLength": 128,
+            "minLength": 1,
+            "type": "string"
+          },
+          "url": {
+            "title": "Url",
+            "type": "string"
+          }
+        },
+        "required": [
+          "tab_id",
+          "url",
+          "final_url",
+          "new_tab"
+        ],
+        "title": "PageNavigateData",
+        "type": "object"
+      },
+      "message": {
+        "type": "string"
+      },
+      "ok": {
+        "const": true
+      }
+    },
+    "required": [
+      "ok",
+      "message",
+      "data"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "data": {
+        "additionalProperties": true,
+        "type": "object"
+      },
+      "error": {
+        "additionalProperties": false,
+        "properties": {
+          "code": {
+            "type": "string"
+          },
+          "details": {
+            "additionalProperties": true,
+            "type": "object"
+          },
+          "message": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "code",
+          "message"
+        ],
+        "type": "object"
+      },
+      "message": {
+        "type": "string"
+      },
+      "ok": {
+        "const": false
+      }
+    },
+    "required": [
+      "ok",
+      "message",
+      "error"
+    ],
+    "type": "object"
+  }
+]

Changed1 schema field changedv0.7.2Jul 22, 2026

changedOutput schema / oneOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "data": {
-        "additionalProperties": false,
-        "properties": {
-          "changes": {
-            "additionalProperties": false,
-            "properties": {
-              "active_element": {
-                "anyOf": [
-                  {
-                    "additionalProperties": true,
-                    "properties": {
-                      "selector": {
-                        "type": "string"
-                      },
-                      "tag": {
-                        "type": "string"
-                      },
-                      "text": {
-                        "type": "string"
-                      }
-                    },
-                    "type": "object"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "appeared_texts": {
-                "items": {
-                  "type": "string"
-                },
-                "type": "array"
-              },
-              "console_errors_added": {
-                "type": "integer"
-              },
-              "console_warnings_added": {
-                "type": "integer"
-              },
-              "counts_after": {
-                "additionalProperties": {
-                  "type": "integer"
-                },
-                "type": "object"
-              },
-              "counts_before": {
-                "additionalProperties": {
-                  "type": "integer"
-                },
-                "type": "object"
-              },
-              "counts_delta": {
-                "additionalProperties": {
-                  "type": "integer"
-                },
-                "type": "object"
-              },
-              "new_console_messages": {
-                "items": {
-                  "additionalProperties": false,
-                  "properties": {
-                    "column": {
-                      "type": "integer"
-                    },
-                    "index": {
-                      "type": "integer"
-                    },
-                    "level": {
-                      "type": "string"
-                    },
-                    "line": {
-                      "type": "integer"
-                    },
-                    "source": {
-                      "type": "string"
-                    },
-                    "text": {
-                      "type": "string"
-                    },
-                    "url": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "index",
-                    "level",
-                    "text",
-                    "url",
-                    "line",
-                    "column",
-                    "source"
-                  ],
-                  "title": "ConsoleLog",
-                  "type": "object"
-                },
-                "type": "array"
-              },
-              "ready_state": {
-                "type": "string"
-              },
-              "removed_texts": {
-                "items": {
-                  "type": "string"
-                },
-                "type": "array"
-              },
-              "title_after": {
-                "type": "string"
-              },
-              "title_before": {
-                "type": "string"
-              },
-              "title_changed": {
-                "type": "boolean"
-              },
-              "url_after": {
-                "type": "string"
-              },
-              "url_before": {
-                "type": "string"
-              },
-              "url_changed": {
-                "type": "boolean"
-              }
-            },
-            "required": [
-              "url_before",
-              "url_after",
-              "url_changed",
-              "title_before",
-              "title_after",
-              "title_changed",
-              "ready_state",
-              "counts_before",
-              "counts_after",
-              "counts_delta",
-              "appeared_texts",
-              "removed_texts",
-              "active_element",
-              "console_errors_added",
-              "console_warnings_added",
-              "new_console_messages"
-            ],
-            "title": "PageObservationChanges",
-            "type": "object"
-          },
-          "final_url": {
-            "type": "string"
-          },
-          "new_tab": {
-            "type": "boolean"
-          },
-          "tab_id": {
-            "type": "string"
-          },
-          "url": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "url",
-          "final_url",
-          "new_tab",
-          "tab_id"
-        ],
-        "title": "PageNavigateData",
-        "type": "object"
-      },
-      "message": {
-        "type": "string"
-      },
-      "ok": {
-        "const": true
-      }
-    },
-    "required": [
-      "ok",
-      "message",
-      "data"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "data": {
-        "additionalProperties": true,
-        "type": "object"
-      },
-      "error": {
-        "additionalProperties": false,
-        "properties": {
-          "code": {
-            "type": "string"
-          },
-          "details": {
-            "additionalProperties": true,
-            "type": "object"
-          },
-          "message": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "code",
-          "message"
-        ],
-        "type": "object"
-      },
-      "message": {
-        "type": "string"
-      },
-      "ok": {
-        "const": false
-      }
-    },
-    "required": [
-      "ok",
-      "message",
-      "error"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "data": {
+        "additionalProperties": false,
+        "properties": {
+          "changes": {
+            "anyOf": [
+              {
+                "additionalProperties": true,
+                "type": "object"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "title": "Changes"
+          },
+          "final_url": {
+            "title": "Final Url",
+            "type": "string"
+          },
+          "new_tab": {
+            "title": "New Tab",
+            "type": "boolean"
+          },
+          "tab_id": {
+            "title": "Tab Id",
+            "type": "string"
+          },
+          "url": {
+            "title": "Url",
+            "type": "string"
+          }
+        },
+        "required": [
+          "url",
+          "final_url",
+          "new_tab",
+          "tab_id"
+        ],
+        "title": "PageNavigateData",
+        "type": "object"
+      },
+      "message": {
+        "type": "string"
+      },
+      "ok": {
+        "const": true
+      }
+    },
+    "required": [
+      "ok",
+      "message",
+      "data"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "data": {
+        "additionalProperties": true,
+        "type": "object"
+      },
+      "error": {
+        "additionalProperties": false,
+        "properties": {
+          "code": {
+            "type": "string"
+          },
+          "details": {
+            "additionalProperties": true,
+            "type": "object"
+          },
+          "message": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "code",
+          "message"
+        ],
+        "type": "object"
+      },
+      "message": {
+        "type": "string"
+      },
+      "ok": {
+        "const": false
+      }
+    },
+    "required": [
+      "ok",
+      "message",
+      "error"
+    ],
+    "type": "object"
+  }
+]

Changed3 schema fields changedv0.5.1Jul 6, 2026

addedInput schema / properties / new_tab

Added value: +{
+  "default": false,
+  "description": "Open the URL in a new browser tab instead of the current tab.",
+  "title": "New Tab",
+  "type": "boolean"
+}

addedInput schema / properties / observe

Added value: +{
+  "default": false,
+  "description": "Return a compact before/after page change summary.",
+  "title": "Observe",
+  "type": "boolean"
+}

changedOutput schema / oneOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "data": {
-        "additionalProperties": false,
-        "properties": {
-          "final_url": {
-            "type": "string"
-          },
-          "url": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "url",
-          "final_url"
-        ],
-        "title": "PageNavigateData",
-        "type": "object"
-      },
-      "message": {
-        "type": "string"
-      },
-      "ok": {
-        "const": true
-      }
-    },
-    "required": [
-      "ok",
-      "message",
-      "data"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "data": {
-        "additionalProperties": true,
-        "type": "object"
-      },
-      "error": {
-        "additionalProperties": false,
-        "properties": {
-          "code": {
-            "type": "string"
-          },
-          "details": {
-            "additionalProperties": true,
-            "type": "object"
-          },
-          "message": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "code",
-          "message"
-        ],
-        "type": "object"
-      },
-      "message": {
-        "type": "string"
-      },
-      "ok": {
-        "const": false
-      }
-    },
-    "required": [
-      "ok",
-      "message",
-      "error"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "data": {
+        "additionalProperties": false,
+        "properties": {
+          "changes": {
+            "additionalProperties": false,
+            "properties": {
+              "active_element": {
+                "anyOf": [
+                  {
+                    "additionalProperties": true,
+                    "properties": {
+                      "selector": {
+                        "type": "string"
+                      },
+                      "tag": {
+                        "type": "string"
+                      },
+                      "text": {
+                        "type": "string"
+                      }
+                    },
+                    "type": "object"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "appeared_texts": {
+                "items": {
+                  "type": "string"
+                },
+                "type": "array"
+              },
+              "console_errors_added": {
+                "type": "integer"
+              },
+              "console_warnings_added": {
+                "type": "integer"
+              },
+              "counts_after": {
+                "additionalProperties": {
+                  "type": "integer"
+                },
+                "type": "object"
+              },
+              "counts_before": {
+                "additionalProperties": {
+                  "type": "integer"
+                },
+                "type": "object"
+              },
+              "counts_delta": {
+                "additionalProperties": {
+                  "type": "integer"
+                },
+                "type": "object"
+              },
+              "new_console_messages": {
+                "items": {
+                  "additionalProperties": false,
+                  "properties": {
+                    "column": {
+                      "type": "integer"
+                    },
+                    "index": {
+                      "type": "integer"
+                    },
+                    "level": {
+                      "type": "string"
+                    },
+                    "line": {
+                      "type": "integer"
+                    },
+                    "source": {
+                      "type": "string"
+                    },
+                    "text": {
+                      "type": "string"
+                    },
+                    "url": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "index",
+                    "level",
+                    "text",
+                    "url",
+                    "line",
+                    "column",
+                    "source"
+                  ],
+                  "title": "ConsoleLog",
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "ready_state": {
+                "type": "string"
+              },
+              "removed_texts": {
+                "items": {
+                  "type": "string"
+                },
+                "type": "array"
+              },
+              "title_after": {
+                "type": "string"
+              },
+              "title_before": {
+                "type": "string"
+              },
+              "title_changed": {
+                "type": "boolean"
+              },
+              "url_after": {
+                "type": "string"
+              },
+              "url_before": {
+                "type": "string"
+              },
+              "url_changed": {
+                "type": "boolean"
+              }
+            },
+            "required": [
+              "url_before",
+              "url_after",
+              "url_changed",
+              "title_before",
+              "title_after",
+              "title_changed",
+              "ready_state",
+              "counts_before",
+              "counts_after",
+              "counts_delta",
+              "appeared_texts",
+              "removed_texts",
+              "active_element",
+              "console_errors_added",
+              "console_warnings_added",
+              "new_console_messages"
+            ],
+            "title": "PageObservationChanges",
+            "type": "object"
+          },
+          "final_url": {
+            "type": "string"
+          },
+          "new_tab": {
+            "type": "boolean"
+          },
+          "tab_id": {
+            "type": "string"
+          },
+          "url": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "url",
+          "final_url",
+          "new_tab",
+          "tab_id"
+        ],
+        "title": "PageNavigateData",
+        "type": "object"
+      },
+      "message": {
+        "type": "string"
+      },
+      "ok": {
+        "const": true
+      }
+    },
+    "required": [
+      "ok",
+      "message",
+      "data"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "data": {
+        "additionalProperties": true,
+        "type": "object"
+      },
+      "error": {
+        "additionalProperties": false,
+        "properties": {
+          "code": {
+            "type": "string"
+          },
+          "details": {
+            "additionalProperties": true,
+            "type": "object"
+          },
+          "message": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "code",
+          "message"
+        ],
+        "type": "object"
+      },
+      "message": {
+        "type": "string"
+      },
+      "ok": {
+        "const": false
+      }
+    },
+    "required": [
+      "ok",
+      "message",
+      "error"
+    ],
+    "type": "object"
+  }
+]

Changed2 schema fields changedv0.5.0Jun 29, 2026
- addedInput schema / additionalProperties
```
Added value: +false
```
- removedOutput schema / additionalProperties
```
Removed value: -false
```
First observedv0.4.1Jun 26, 2026

TDQS

C2.9/5.0

Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare destructiveHint=true, openWorldHint=true, and non-idempotent, so the safety profile is covered structurally. The description itself adds no behavioral context — it does not mention that navigating discards current page state, that tab switch/context creation is possible, or any auth/redirect behavior. It does not contradict the annotations, but it contributes nothing beyond them.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

A single efficient clause with no filler, front-loading the verb and resource. It is terse to the point of under-specification for a 7-parameter, destructive tool, but as a structure it is clean and waste-free.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so return values need not be described, and the schema fully documents parameters. Given the destructive, open-world nature and the tab/window/context branching options, the description is only minimally adequate — it omits the state-loss implication of navigation that an agent should weigh before calling.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100% and each parameter (tab_id, new_tab, observe, background, new_window, new_context) is documented in the schema, including the dependency requirements. The description adds no parameter meaning beyond that, so the baseline 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

Names a specific verb (navigate) and resource (URL in browser), so the core action is unambiguous. It does not differentiate from close siblings such as page_navigate_with_http_auth, page_go_back, or page_refresh, so an agent must infer the boundary from the name alone.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

There is no when-to-use guidance, no mention of alternatives like go_back/refresh or the http-auth variant, and no note that this mutates the current tab's state. The description gives no routing signal beyond the bare action.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Deploy Server

Navigate to URL

Instructions

Input Schema

Output Schema

Schema Changelog

TDQS

Other Tools