GPALRestAPI

GPALRestAPI scans for a free port starting at 3000 and, once bound, broadcasts the port number over UDP to 127.0.0.1:47623 so clients find it automatically. GPAL receives this and sets that browser's RestApiBaseUrl for you, readable as browser.RestApiBaseUrl. Each browser hears its own, so two browsers running OttoMagic each address their own server. A browser that never hears a port does not finish starting, so a browser you are holding always has one.

GPALRestAPI is also an MCP server. MCP, the Model Context Protocol, is how AI assistants such as Claude Code, Claude Desktop, Cursor and VS Code are given tools. POST /mcp offers every OttoMagic endpoint in openapi.yaml as a tool, with its parameters as the tool's inputs, so an assistant can drive your own browser, signed in as you, by asking. In Claude Code it is one line: claude mcp add --transport http gpal http://localhost:3000/mcp. The port is the one the server bound, 3000 unless something else had it.

GET /help lists every endpoint and what it takes, read from the same openapi.yaml, grouped as GPALRestAPI, OttoMatic and OttoMagic commands.

NOTE

There isn't much to set up here: download the installer and OttoMagic runs it. GPALRestAPI and OttoMagic work together and are useless separated.

Features

REST endpoints for everything: navigation, element interaction and queries, script injection before page load, storage across all storage types, page inspection, and DOM context switching
Language agnostic: any client that can make HTTP calls (GPAL, Python, Node.js, or curl) can drive the browser
Automatic port discovery: scans for a free port from 3000 and broadcasts it over UDP to 127.0.0.1:47623 so clients connect without configuration
OpenAPI documented: a bundled openapi.yaml documents every endpoint and its parameters for non-GPAL clients
An MCP server for AI assistants: POST /mcp offers every OttoMagic endpoint as a tool, so Claude and other assistants can drive your own browser; add it with claude mcp add --transport http gpal http://localhost:3000/mcp
Typed GPAL client: browser.OttoMagicClient is a ready-made fluent wrapper wired to these endpoints

Product page Download the installer

Documentation Example

Documentation

Showing off some plain text in these paragraphs eligendi laboriosam illo nostrum corporis at libero vel voluptas? Expedita, facere dolores voluptatem ad ab rem assumenda soluta!

Other formats

Here you can find different accents and emphasis sit amet consectetur adipisicing elit. Obcaecati, iste distinctio veritatis eligendi laboriosam illo nostrum corporis at libero vel voluptas? Expedita, facere dolores voluptatem ad ab rem assumenda soluta!

This is a link and how it could look like bestlinkinthebeautifulworld. Obcaecati, iste distinctio veritatis eligendi laboriosam illo nostrum corporis at libero vel voluptas? Expedita, facere dolores voluptatem ad ab rem assumenda soluta!

Here's just some classic bold text adipisicing elit. Obcaecati, iste distinctio veritatis eligendi laboriosam notBoldSecondbestlinkinthebeautifulworld illo nostrum corporis at libero vel voluptas? Expedita, facere dolores voluptatem ad ab rem assumenda soluta!

Obcaecati, iste distinctio veritatis eligendi laboriosam adipisicing elit illo nostrum corporis at adipisicing elit libero vel voluptas? Expedita, adipisicing facere dolores voluptatem ad ab rem assumenda soluta!

Other cuple of colors in case we want to emphasize several ways adipisicing elit. Obcaecati, iste distinctio veritatis eligendi laboriosam adipisicing elit illo nostrum corporis at voluptatem libero vel voluptas? Expedita, facere dolores voluptatem ad ab rem assumenda soluta!

Adding Images to the content

Lorem ipsum dolor sit amet consectetur adipisicing elit. Obcaecati, iste distinctio veritatis eligendi laboriosam illo nostrum corporis at libero vel voluptas? Expedita, facere dolores voluptatem ad ab rem assumenda soluta! Lorem ipsum dolor, sit amet consectetur adipisicing elit. Quod veniam, quam ad expedita laborum sed at voluptates culpa ipsam ut vel. Ullam temporibus a mollitia quod aliquam ratione exercitationem nesciunt.

Coding Blocks

Lorem ipsum dolor sit amet consectetur adipisicing elit. Repudiandae quas consequuntur illo numquam assumenda autem exercitationem distinctio perspiciatis in natus. Eius dicta similique ipsam ipsa minima, nemo quae enim tempore.

GPAL

.CallIfNotFound(GenericCallIfNotFound)

.WithPublishToConsole();

//System.Drawing.Rectangle windowSize = new System.Drawing.Rectangle(10, 10, 1500, 1024);

// NOTE: we have to set browser = before we execute any steps

// this is due to the 'GenericCallIfNotFound' which might throw an exception, and BankScraper will not have the browser set when it calls scraper.Close()

// until the complete fluent line gets executed (meaning every step, meaning browser is not set until everything else succeeds)

browser = GPAL.Browser

.WithBrowserType(Enums.BrowserType.Chrome)

.WithProfileDataDirectory(ChromeProfileLocation)

.WithUseAutomationEngine(AutomationEngine.Selenium)

.WithWindowSize(new System.Drawing.Rectangle(0,0,1920,1080))

.ToGPALObject();

GPALRestAPI

GPALRestAPI

GPALRestAPI

Features

Documentation Example

Documentation

Category

Endpoint

Enpoint

Enpoint

Enpoint

Other formats

Adding Images to the content

Coding Blocks

On this page