Built for AI agents

Your site, agent-ready.

Surf is the open protocol that lets AI agents discover and interact with your website without screenshots, scraping, or guesswork. One manifest. Every agent.

Read the docs →
Try the demo

Three commands. That's it.

Discover a site, run a pipeline, ship typed client code. Here's what it looks like.

Discover a site
$ curl https://shop.com/.well-known/surf.json
{
"name": "Ocean Shop",
"version": "1.0",
"commands": {
"search": { "method": "GET", "path": "/surf/search" },
"cart.add": { "method": "POST", "path": "/surf/cart/add" },
"checkout": { "method": "POST", "path": "/surf/checkout" }
}
}
 
# Site discovered. 3 commands available.

How it works

Three steps from zero to agent-ready.

01

You publish surf.json

Add a manifest at /.well-known/surf.json describing your site's commands — search, add-to-cart, checkout, whatever makes sense. Takes 10 minutes.

$npx surfjs init
02

Agent discovers it

Any AI agent fetches your manifest and instantly knows what your site can do — no scraping, no guessing, no brittle selectors.

$curl https://yoursite.com/.well-known/surf.json
03

Done in milliseconds

The agent calls your typed API endpoints directly via Surf's pipeline. Full e-commerce checkout in 47ms. Zero screenshots.

$POST /surf/pipeline
/.well-known/surf.json

One manifest.
Every agent.

The surf.json manifest is a machine-readable description of everything your site can do. Agents discover it automatically — the same way browsers read favicon.ico, agents read surf.json.

  • Typed command schemas — no guessing
  • Auth requirements declared up-front
  • Pipeline support built-in
  • Human-readable descriptions for LLM context
shell
$curl https://surf.codes/.well-known/surf.json
surf.json
{
  "name": "Ocean Shop",
  "version": "1.0",
  "commands": {
    "search": {
      "method": "GET",
      "path": "/ surf/search",
      "description": "Search products"
    },
    "cart.add": {
      "method": "POST",
      "auth": "session",
      "input": { ... }
    },
    "checkout": { ... }
  }
}

Any site. Any agent.

Surf works wherever agents need to take action.

E-commerce

Product search, cart management, checkout flows — agents complete purchases without ever rendering a page.

Webshop guide →

Content & Research

Let agents search your knowledge base, fetch articles, or navigate docs trees — structured, typed, fast.

Info site guide →

Live Data Apps

Stream real-time data to agents — dashboards, analytics, inventory counts — via Surf's SSE streaming support.

Realtime guide →

psst — you found the secret terminal

Go on, type something.

agent shell — try a command

Try: surf vibes · surf help · sudo surf

$

Ready to make your site
agent-native?

10 minutes to your first surf.json. Then every agent in the world can use your site.

Get startedBrowse guides