Tell your AI what to do

You don't write code to use Scout. Just tell your AI what you need, in Cursor, Claude, VS Code, or any agent client.

Data Extraction

“Go to techcrunch.com and extract the top 5 headlines with their URLs as JSON”

Form Filling

“Navigate to the signup page, fill in the form with test data, and submit it”

Visual Testing

“Take screenshots of our landing page at mobile, tablet, and desktop sizes”

Debugging

“Open staging.example.com and report any console errors or failed network requests”

Research

“Crawl our docs site and list every page that mentions "rate limiting"”

Multi-step Workflow

“Log into the dashboard, navigate to billing, and download the latest invoice as PDF”

Monitoring

“Check if the hero banner on our homepage is rendering correctly in both light and dark mode”

Competitive Analysis

“Go to three competitor pricing pages and extract their plan names, prices, and feature lists”

Examples

Code examples

Real-world automation patterns using Scout's MCP tools. Copy these directly into your agent code.

extract-data.tsTYPESCRIPT

// Extract product listings from an e-commerce page
await client.callTool({
  name: "browser-navigate",
  arguments: { action: "goto", url: "https://store.example.com/products", sessionRef },
});

// Extract article content (uses Defuddle)
const article = await client.callTool({
  name: "browser-extract",
  arguments: { property: "article", sessionRef },
});
// → { title: "...", content: "...", excerpt: "..." }

// Extract text from a specific element
const text = await client.callTool({
  name: "browser-extract",
  arguments: { property: "text", selector: ".product-list", sessionRef },
});

Quickstart snippets

Small examples for the browser automation loop.

MCP tokenJSON

{
  "mcpServers": {
    "scout": {
      "type": "http",
      "url": "https://mcp.scout.i.ng/browser",
      "headers": {
        "Authorization": "Bearer <mcp-token>"
      }
    }
  }
}

Programmatic client fallbackTYPESCRIPT

import { Client } from "@modelcontextprotocol/sdk/client";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";

const transport = new StreamableHTTPClientTransport(
  new URL("https://mcp.scout.i.ng/browser"),
  {
    requestInit: {
      headers: {
        Authorization: "Bearer " + process.env.SCOUT_MCP_TOKEN,
      },
    },
  },
);

const client = new Client({ name: "batch-runner", version: "1.0.0" });
await client.connect(transport);

const { tools } = await client.listTools();
console.log(tools.map((tool) => tool.name));

const result = await client.callTool({
  name: "browser-launch",
  arguments: { url: "https://example.com" },
});

console.log(result);

End-to-end recipes

Choose a workflow to see its steps and example code.

Navigate to a page and extract content using DOM property extraction.

Navigate to the target URL
Snapshot the main content area with decorative filtering
Use browser-extract with property: 'article' for clean content or 'text' for element text

Extract Structured DataTYPESCRIPT

// 1. Navigate to the target page
await callTool("browser-navigate", {
  action: "goto",
  url: "https://example.com/products",
});

// 2. Take a filtered snapshot (main content only)
const snapshot = await callTool("browser-snapshot", {
  selector: "main",
  excludeDecorative: true,
});

// 3. Extract article content (clean markdown via Defuddle)
const article = await callTool("browser-extract", {
  property: "article",
});

// 4. Or extract specific element text
const heading = await callTool("browser-extract", {
  property: "text",
  selector: "h1",
});

Fill form fields and submit using element refs from the accessibility snapshot.

Snapshot the page to discover form field refs
Fill each field using browser-interact with action: fill
Click the submit button
Re-snapshot to verify the result

Fill and Submit FormsTYPESCRIPT

// 1. Snapshot to find the form
const snapshot = await callTool("browser-snapshot");

// 2. Fill in the form fields using @e refs from the snapshot
await callTool("browser-interact", {
  action: "fill",
  elementRef: "@e12",        // email input
  text: "user@example.com",
});
await callTool("browser-interact", {
  action: "fill",
  elementRef: "@e14",        // password input
  text: "secure-password",
});

// 3. Click the submit button
await callTool("browser-interact", {
  action: "click",
  elementRef: "@e18",        // submit button
});

// 4. Wait for navigation and verify
const result = await callTool("browser-snapshot");

Block unnecessary resources and crawl multiple pages for bulk content extraction.

Set up route interception to block images, fonts, and CSS
Navigate to the starting page
Use browser-crawl with an extraction expression

Efficient Multi-Page CrawlingTYPESCRIPT

// Block images and stylesheets to speed up page loads
await callTool("browser-route", {
  pattern: "**/*.{png,jpg,gif,svg,css,woff,woff2}",
  action: "abort",
});

// Navigate and extract — pages load faster without media
await callTool("browser-navigate", {
  action: "goto",
  url: "https://example.com/articles",
});

// Crawl with resource blocking built in
const results = await callTool("browser-crawl", {
  urls: ["https://example.com/articles"],
  enqueueStrategy: "same-hostname",
  maxRequestsPerCrawl: 50,
  blockedResources: ["image", "stylesheet", "font", "media"],
  expression: "document.querySelector('article')?.innerText",
});

Set viewport size, user agent, and network throttling to test responsive design and performance.

Resize viewport to mobile dimensions with browser-resize
Set user agent and locale with browser-emulate
Apply network throttling with custom throughput and latency values
Navigate and capture a full-page screenshot
Collect performance metrics

Mobile Device TestingTYPESCRIPT

// 1. Set mobile viewport size
await callTool("browser-resize", {
  width: 390,
  height: 844,
});

// 2. Set mobile user agent and locale
await callTool("browser-emulate", {
  userAgent: "Mozilla/5.0 (iPhone; CPU iPhone OS 17_0 like Mac OS X) AppleWebKit/605.1.15",
  locale: "en-US",
  colorScheme: "light",
});

// 3. Simulate slow network conditions
await callTool("browser-throttle", {
  downloadThroughput: 50000,    // 50 KB/s (slow 3G)
  uploadThroughput: 25000,      // 25 KB/s
  latency: 2000,                // 2s RTT
});

// 4. Navigate and screenshot for visual comparison
await callTool("browser-navigate", { action: "goto", url: "https://example.com");
const screenshot = await callTool("browser-screenshot", {
  target: "page",
});

// 5. Check performance metrics
const metrics = await callTool("browser-metrics");
// → { domContentLoaded, domInteractive, firstContentfulPaint, firstPaint, loadComplete }

Handle file downloads, attachments, and clipboard operations in automated workflows.

Use browser-download to wait for and capture downloads
Use browser-attach to attach files to <input type='file'> elements
Use browser-evaluate for clipboard access

File & Clipboard OperationsTYPESCRIPT

// 1. Set up clipboard read access
await callTool("browser-evaluate", {
  expression: "await navigator.clipboard.readText()",
});

// 2. Click a download button and check downloads
await callTool("browser-interact", {
  action: "click",
  elementRef: "@e25",            // "Download PDF" button
});
const downloads = await callTool("browser-download", {
  action: "list",          // list all downloads
});

// 3. Attach a file to a file input
await callTool("browser-attach", {
  selector: "input[type=file]",
  files: ["/path/to/document.pdf"],
});