Import.io

Page Links

importio_page_links

Compact helper: optionally navigate to a URL, then return visible meaningful links from rendered HTML with text, resolved href, and optional surrounding context. Pairs with importio_page_text or importio_search_cards when deciding what to open next without dumping raw HTML. URL navigation supports managed proxy selection and bounded blocked-page retries. snake_case and camelCase parameter names are equivalent aliases (wait_for_selector / waitForSelector, max_links / maxLinks, include_context / includeContext); provide either form.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "importio_page_links"
  }
}

Input Schema

Name	Required	Description
`url`	No	Optional URL to navigate to before collecting links; omit it to use the current page.
`wait`	No	Wait for the page load to settle before collecting links.
`maxLinks`	No	Alias of max_links; provide either form.
`max_links`	No	Maximum number of links returned.
`proxy_retry`	No	Bounded blocked-page retry policy for the navigation.
`includeContext`	No	Alias of include_context; provide either form.
`include_context`	No	Include surrounding text context with each link.
`proxy_selection`	No	Managed proxy selection for the navigation; omit it to use the server default.
`waitForSelector`	No	Alias of wait_for_selector; provide either form.
`wait_for_selector`	No	CSS selector that must exist before links are collected.

Output Schema

Name	Required	Description	Default
`count`	Yes
`links`	Yes
`truncated`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed18 schema fields changedNov 9, 2026

addedInput schema / properties / includeContext / description

Added value: +"Alias of include_context; provide either form."

addedInput schema / properties / include_context / description

Added value: +"Include surrounding text context with each link."

addedInput schema / properties / maxLinks / description

Added value: +"Alias of max_links; provide either form."

addedInput schema / properties / max_links / description
```
Added value: +"Maximum number of links returned."
```

addedInput schema / properties / proxy_retry / description

Added value: +"Bounded blocked-page retry policy for the navigation."

addedInput schema / properties / proxy_retry / properties / allowResidential

Added value: +{
+  "description": "Alias of allow_residential; provide either form.",
+  "type": "boolean"
+}

addedInput schema / properties / proxy_retry / properties / allow_residential / description

Added value: +"Allow escalation to residential proxies when cheaper pools keep failing."

addedInput schema / properties / proxy_retry / properties / enabled / description
```
Added value: +"Enable bounded navigation retries with fresh proxy checkouts."
```

addedInput schema / properties / proxy_retry / properties / inferCountry

Added value: +{
+  "description": "Alias of infer_country; provide either form.",
+  "type": "boolean"
+}

addedInput schema / properties / proxy_retry / properties / infer_country / description

Added value: +"Infer the proxy country from the URL when proxy_selection.country is not set."

addedInput schema / properties / proxy_retry / properties / maxAttempts

Added value: +{
+  "description": "Alias of max_attempts; provide either form.",
+  "maximum": 3,
+  "minimum": 1,
+  "type": "integer"
+}

addedInput schema / properties / proxy_retry / properties / max_attempts / description
```
Added value: +"Maximum navigation attempts including the first (1 to 3)."
```

addedInput schema / properties / proxy_selection / description

Added value: +"Managed proxy selection for the navigation; omit it to use the server default."

addedInput schema / properties / proxy_selection / properties / type / description
```
Added value: +"Proxy pool to use."
```

addedInput schema / properties / url / description

Added value: +"Optional URL to navigate to before collecting links; omit it to use the current page."

addedInput schema / properties / wait / description

Added value: +"Wait for the page load to settle before collecting links."

addedInput schema / properties / waitForSelector / description

Added value: +"Alias of wait_for_selector; provide either form."

addedInput schema / properties / wait_for_selector / description

Added value: +"CSS selector that must exist before links are collected."

First observedNov 9, 2026

TDQS

A4/5.0

Behavior3/5

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

Annotations already flag openWorldHint=true and readOnlyHint=false; the description adds useful behavior beyond them, namely managed proxy selection and bounded blocked-page retries, which explain why a link-read tool is not read-only. However, it never says that supplying a URL navigates away from and replaces the current page state, which is the main side effect an agent needs to know about.

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

Conciseness5/5

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

Three sentences, front-loaded with the core action and its output shape, then differentiation from siblings, then the proxy/retry caveat. The alias sentence is somewhat boilerplate but is placed last where it costs least.

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

Completeness4/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-value details need not be spelled out, and the description covers purpose, sibling routing, and the proxy/retry behavior of a 10-parameter nested tool. The remaining gap is the side effect of navigation on the current page and any note on link ordering or deduplication.

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 coverage is 100%, so every parameter, including nested proxy_selection and proxy_retry fields, is already documented; the baseline of 3 applies. The description's alias note (snake_case/camelCase equivalence) duplicates what the individual schema properties already state, adding no new semantics.

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

Purpose5/5

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

The description gives a specific verb and resource ('return visible meaningful links from rendered HTML') plus the shape of each result (text, resolved href, optional context). It also names the sibling tools it complements (importio_page_text, importio_search_cards), so an agent can place it in the toolset without opening the schema.

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

Usage Guidelines4/5

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

It states the intended use clearly – 'when deciding what to open next without dumping raw HTML' – and points to the alternatives it pairs with. It stops short of explicit when-not guidance (e.g. use page_text when you want prose, get_html when you need raw markup), so it is strong but not fully exclusionary.

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

All Import.io tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?