explaingit

segentic-lab/periscope-mcp

Analysis updated 2026-05-18

★ 7PythonAudience · developerComplexity · 3/5Setup · moderate

TLDR

An MCP server that gives AI agents 74 tools to test, audit, and QA websites and web apps, returning clear pass or fail results instead of screenshots.

Mindmap

mindmap
  root((Periscope MCP))
    What it does
      Web app QA for AI agents
      74 Playwright tools
      Hard pass fail results
    Tech stack
      Python
      Playwright
      Chromium
      MCP protocol
    Use cases
      Form auto fill testing
      Site wide crawl audits
      Authenticated flow testing
    Audience
      Developers
      AI agent builders
      QA engineers
    Notable features
      Accessibility and SEO checks
      2FA and SSO login support
      Flags silent failures

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Have an AI agent automatically fill out and test forms on a web app, including sites that need login.

USE CASE 2

Crawl an entire website and get a report on accessibility, SEO, broken links, and performance issues.

USE CASE 3

Test authenticated flows, including two factor authentication and single sign on, using a one time interactive login.

USE CASE 4

Catch silent failures in browser automation, like a drag action that appears to succeed but changes nothing.

What is it built with?

PythonPlaywrightChromiumMCPDocker

How does it compare?

segentic-lab/periscope-mcpalx-code/lingbot-video-1.3b-fp8bettyguo/local-deep-research
Stars777
LanguagePythonPythonPython
Setup difficultymoderate——
Complexity3/5——
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Python 3.11+ and Playwright with a Chromium browser, an install script handles most of the setup.

In plain English

Periscope is a tool that lets AI agents test and audit websites and web apps, using a standard called MCP that lets AI assistants like Claude call outside tools. Instead of giving an agent raw browser control and asking it to squint at screenshots, Periscope offers 74 ready made tools that check things and return a clear pass or fail answer, along with the actual value that was found.this includes checking accessibility, SEO, and how well a site can be found and understood by AI powered search tools. The tools are built around the kinds of tasks a real tester would do. One tool can detect and fill out an entire form on its own, guessing sensible values for each field. Another can run a batch of up to 25 actions in one go, like clicking, typing, and checking results, instead of one call per step. A separate tool can crawl a whole website and audit every page for accessibility, SEO, broken links, and performance, saving a report at the end. It can also log into websites that require a username and password, or even handle two factor authentication and single sign on by opening a visible browser window for a human like login step, then continuing headlessly afterward. Under the hood, Periscope runs on Playwright, a browser automation library, controlling a headless version of Chrome. It keeps track of ongoing browser sessions, stores project configurations as JSON files, and saves screenshots, videos, and reports so an agent can review what happened. When something silently fails, such as a drag and drop that does not actually move anything, Periscope flags it as a failure instead of reporting false success, and explains what likely went wrong. It is written in Python, requires Python 3.11 or newer, and depends on Playwright with a Chromium browser. Installation is done through a shell script that sets up a virtual environment, installs dependencies, and configures the tool for use with any MCP compatible AI assistant, such as Claude Code, Cursor, or Windsurf. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1
Set up Periscope MCP so I can test my web app's login flow, including two factor authentication.
Prompt 2
Use Periscope to crawl my site and give me an accessibility and SEO audit report.
Prompt 3
Show me how to use auto_fill_form to test a signup form on my website automatically.
Prompt 4
Help me configure Periscope's persistent sessions so I don't have to log in again for every test.

Frequently asked questions

What is periscope-mcp?

An MCP server that gives AI agents 74 tools to test, audit, and QA websites and web apps, returning clear pass or fail results instead of screenshots.

What language is periscope-mcp written in?

Mainly Python. The stack also includes Python, Playwright, Chromium.

How hard is periscope-mcp to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is periscope-mcp for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.

Alternatives & similar repos