# Gecko

> The API comprehension layer for agents. Open source. Control-plane only.

**The API comprehension layer for agents · Open source**

## Your agent read the docs. It still called the API wrong.

Point Gecko at any painful API. Auth handled. First call correct.

### Install

```bash
curl -fsSL https://get.geckovision.tech/install.sh | bash
```

Alternative: `uv tool install "gecko-surf[serve]"`

## Metrics

- **442** — tests green
- **2** — real APIs, live on Solana mainnet
- **5×** — first-call-correct on a painful API (measured)
- **8/8 → 0/8** — poisoned-spec attacks blocked

## The spec is public. The correct first call is engineering.

The engine is open source and free. Keeping it correct as the API drifts is what we're building the cloud for.

## 01 — COMPREHEND (Live)

### A human-shaped spec becomes a tool your agent picks by intent.

Point Gecko at any OpenAPI — no provider help. It returns a handful of first-call-correct tools the agent chooses by intent, not dozens of raw operations it has to reverse-engineer. When the spec misdeclares its auth, Gecko resolves it here, before a call goes out.

```
gecko.search("find the latest match odds") → prepare → call(mode="recorded")
```

- Unilateral ingest — point at any spec and get intent-shaped tools; zero provider cooperation, no integration code.
- Auth misdeclared in the spec (a static header typed as oauth2) is caught at comprehension time, not on a failed live call.
- Auth is hidden from the agent — credentials injected at call time, never exposed in a tool def.
- Operations the token can't reach are filtered out, so the agent can't pick a call it can't make.

## 02 — SIMULATE (Live)

### Prove the call before you spend a cent.

recorded mode synthesizes a response straight from the schema. $0, fully offline. Test that the call is correct before any live request touches the API.

- Deterministic examples generated from the schema — no network, no key, no spend.
- One code path for recorded and live; they diverge only at the transport edge.
- Falsify the integration offline first — live smoke is the final check, never the debugger.
- $0 before you commit to a paywalled API — evaluate the fit before you subscribe.

## 03 — TEST (Coming · V2)

### Tests that prove first-call-correctness.

We're building gecko-testgen to auto-generate TDD tests that assert the agent's call matches the spec — and regenerate them when the API drifts.

- Generated tests assert the prepared call matches the surface — green means first-call-correct.
- Re-comprehend on drift: a renamed field regenerates tools and tests, not a 2am hotfix. [Coming · V2]
- Tests are a pure function of the surface — versionable, reviewable, diffable.

## 04 — GO LIVE (Live)

### A hosted MCP your agent adds in one line.

Add Gecko to Claude or Cursor with a single command. Gecko handles the access handshake and injects credentials at call time — invisible to the agent — then the agent calls the real API directly. We are the control plane, never the data plane.

- Streamable-HTTP MCP endpoint — one-click add to Claude or Cursor.
- Gecko handles the access handshake; credentials injected at call time, never custodied or logged. Not a payment rail — your agent calls the real API directly.
- Control-plane only: we store the API surface and generated tools, never a response payload, user data, or a secret. That's the promise that lets us ingest any API unilaterally.
- Drift-resilience we're building: re-comprehend instead of re-integrate when the API changes. [Coming · V2]

## FOR API PROVIDERS

### Make your API the one agents call right — and get paid for it.

Point Gecko at your API and it becomes agent-discoverable and first-call-correct — every agent that reaches for it succeeds the first time. Wire it to your x402 endpoint and those correct calls settle: more usage, more payments. Metera meters it; Gecko multiplies it.

- Agent-discoverable — first-call-correct MCP tools + a one-line add, so every agent finds and uses your API.
- Wired to get paid — we point the tools at your x402 endpoint (PayAI, Metera, or pay.sh). You keep 100%; we never touch a payment.
- Stays correct as you ship — drift-watch re-comprehends when your API changes, so agents don't silently break. [Coming · V2]
- Flat monthly fee per API — never a take-rate on your payments, never a marketplace cut.

## FOR AGENTS

### This page has a twin your agent can read.

The HTML is for humans. Everything an agent needs — the same content as clean Markdown, a machine-readable manifest, and the live MCP endpoint — is published right alongside it. Point your agent at any link below: no scraping, no guessing.

- [llms.txt](https://geckovision.tech/llms.txt): Curated index of this site (llmstxt.org shape).
- [llms-full.txt](https://geckovision.tech/llms-full.txt): The whole landing as one Markdown file.
- [index.md](https://geckovision.tech/index.md): Markdown twin of this page (text/markdown).
- [gecko.json](https://geckovision.tech/gecko.json): Machine-readable product manifest.
- [.well-known/gecko.json](https://geckovision.tech/.well-known/gecko.json): Discovery endpoint — the manifest at a known path.
- [MCP endpoint ↗](https://mcp.geckovision.tech/mcp): Streamable-HTTP — one-click add to Claude or Cursor.
- [docs · llms.txt ↗](https://docs.geckovision.tech/llms.txt): The docs' own agent index, not the human home page.

## Links

- Website: https://geckovision.tech
- Docs: https://docs.geckovision.tech
- GitHub: https://github.com/GeckoVision/gecko-surf
- MCP: https://mcp.geckovision.tech/mcp
- PyPI: https://pypi.org/project/gecko-surf/
- Discord: https://discord.gg/3gVF5NNbCa
- Install: curl -fsSL https://get.geckovision.tech/install.sh | bash

Open source, built in public. © 2026 Gecko · geckovision.tech