Skip to main content
Glama
Sign In
periscope

periscope

by oskar-szulc
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Local

periscope

A command-line browser for AI agents on macOS. It runs Safari's engine (WebKit), so websites see a normal Safari, and it keeps sessions open between commands.

periscope navigate https://books.toscrape.com/ --session demo
periscope text --session demo        # the page as markdown
periscope extract --session demo     # the page's records as JSON
periscope click "text:Next" --session demo

Install

brew install oskar-szulc/tap/periscope
periscope install-skill    # adds the agent skill to this project

Without Homebrew: curl -fsSL https://raw.githubusercontent.com/oskar-szulc/periscope/main/install.sh | sh

To build from source instead (Xcode 26): swift build -c release, then copy .build/release/periscope onto your PATH.

For agents

  • Claude Desktop: download periscope-<version>.mcpb from the latest release and open it

  • Claude Code: /plugin marketplace add oskar-szulc/periscope, then /plugin install periscope@periscope

  • Codex, Cursor and others: npx skills add oskar-szulc/periscope

  • MCP clients: listed in the MCP Registry as io.github.oskar-szulc/periscope; the command is periscope mcp, e.g. claude mcp add periscope -- periscope mcp, or in a JSON config: {"mcpServers": {"periscope": {"command": "periscope", "args": ["mcp"]}}}

  • Any agent with a shell: periscope docs prints the full reference

Related MCP server: Safari MCP Server

Reading a page

Command

Returns

Use it to

text

The page's main content as markdown, links included

Read an article or a post

state

URL, title, headings, the start of the content, and every clickable element with a selector and a number (@3)

Decide what to click or fill next

extract

JSON: the page's repeated items (cards, results, table rows), its structured data, and the next-page link

Scrape a list of jobs, products or results

links

Every link on the page as an absolute URL (--match to filter)

Collect URLs to visit next

screenshot

A PNG of the page as displayed

See the layout, or check visual content

What else you can do

  • Act: click, fill, type, select, scroll, mouse, targeting CSS or what a person sees (text:Next, label:Email)

  • Stay logged in: named sessions persist; login and show let you take over the window

  • Know when you're blocked: CAPTCHA and bot-check pages exit with code 5

Full reference: PERISCOPE.md. Why and how it was built: Building periscope.

Requirements

  • macOS 26 or newer, in a logged-in desktop session with the display on

  • Not inside a shell sandbox (periscope exits with a message if it is)

License

MIT. Contributions: see CONTRIBUTING.md. Made by Oskar Szulc.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    This server cannot be deployed

    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

    Maintenance

    ActivityMaintained
    ResponsivenessOutdated data

    Resources

    Related MCP Connectors

    Related MCP Servers

    • Safari MCP Server

      lxman
      A
      license
      B
      quality
      D
      maintenance
      Provides AI assistants with Safari browser automation and developer tools access, enabling LLMs to control Safari, access console logs, monitor network activity, and perform browser automation tasks.
      13
      9 npm
      33
      MIT

    • Safari MCP Server

      axivo
      A
      license
      A
      quality
      C
      maintenance
      Enables visual web access and browser automation through Safari, with tools for navigation, screenshots, element interaction, and tab management.
      17
      11 npm
      BSD 3-Clause

    • Charlotte

      Burke35546
      A
      license
      Not graded
      quality
      A
      maintenance
      Gives AI agents token-efficient, structured access to web pages through a persistent headless browser session, returning a compact page orientation on arrival, targeted element queries, and full detail only when explicitly requested. Also enables navigation, iframe-aware interaction, form filling, screenshots, console/network monitoring, and scripted auditing of sites.
      4 npm
      MIT

    • browser

      AlexB00M
      F
      license
      Not graded
      quality
      B
      maintenance
      Lets AI agents drive your real, already-logged-in browsers on macOS in the background without stealing focus, organizing work into tab groups, reading pages as compact accessibility snapshots, and saving repeatable scenarios. Supports Chrome, Edge, Brave, Yandex Browser, and Safari, with per-agent isolation and automatic tab cleanup.
      -