Portolan · Author & Maintainer · 2026 - Present
Typed operations for websites, so agents stop clicking
A site-map runtime for agents. Portolan learns a website's states and typed operations, such as search(query) or add_to_cart(product_id, size), from real runs, verifies them by replay, and serves them to any model over MCP, so an agent calls operations instead of clicking through screens.
- Role
- Author & Maintainer
- Stack
- TypeScript · MCP · Agent Skills
- License
- Open source
- Status
- Alpha. Apache-2.0 licensed, published on npm.
Goal.
One map per site that any agent can call, kept correct as the site changes, with writes that are safe by default.
Features.
Operations, not clicks
A ten-click checkout becomes three typed calls. Every click removed is a model step you stop paying for.
Learned and verified
Maps are built from the live DOM and recorded runs, published only when they verify by replay, and repaired when the site changes.
Governed writes
Effects are declared, irreversible operations need confirmation, and a write with an unknown outcome is never silently retried.
Agent-first QA
The same maps let a coding agent author, run and repair end-to-end tests as JSON files in your repository.