Gecko
Open source · built in public

Make any API agent-usable.

First-call-correct agent tools for any OpenAPI — no integration code. Point Gecko at a painful, paywalled, badly-documented API and your agent makes the right call the first time.

The spec is free. The correct first call is not.

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

Prefer a package manager? uv tool install "gecko-surf[serve]" (pip / pipx also work).

GET STARTEDDocsGitHub
gecko — comprehend
01

COMPREHEND

Live

A human-shaped spec becomes question-shaped tools.

Point Gecko at any OpenAPI. It returns a handful of first-call-correct tools the agent picks by intent — not 97 raw operations it has to reverse-engineer.

gecko.search("create a Pix charge") → prepare → call(mode="recorded")
  • N operations collapse into a few intent-shaped tools an agent can actually choose from.
  • 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.
  • $ref resolution with cycle and depth guards — messy specs in, clean tools out.
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.
03

TEST

Coming · V2

Tests that prove first-call-correctness.

gecko-testgenauto-generates TDD tests that assert the agent's call matches the spec — and regenerates 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. Credentials are injected at call time and the agent calls the real API directly.

  • Streamable-HTTP MCP endpoint — one-click add to Claude or Cursor.
  • Credentials injected at call time, never custodied or logged.
  • Control-plane only: we store the surface and tool defs, never your response payloads or secrets.
  • Stays correct as the API drifts — re-comprehend instead of re-integrate.[Coming · V2]