# Gecko

> Gecko makes any API agent-usable — so your agent calls it right the first time.

**The agent's API layer · open source**

## Any API, agent-ready — first call correct.

Reads the docs, hides the auth, gets the call right.

## THE PROBLEM

### Your agent one-shots Stripe. Then it hits the API you actually need — and falls apart.

Wrong endpoint. Wrong auth. 401 after 401 — until you hand-write the client again.

- **Stop babysitting integrations.** Right call, right auth — by intent.
- **Ship without leaking keys.** Credentials injected at call time. Never exposed.
- **Prove it works before you pay.** $0 offline simulation. Correct before a live request.

### Get started

Add the live surface to Claude Code — no key, $0, offline:

```bash
claude mcp add --transport http gecko-txline https://mcp.geckovision.tech/txline/mcp
```

Claude Code plugin: `/plugin marketplace add GeckoVision/gecko-surf` · CLI: `uvx --from "gecko-surf[serve]" gecko serve <your-api>`

## Metrics

- **600+** — tests green
- **2** — real APIs, live on Solana
- **10→65%** — 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.

Open source engine, free forever. The cloud keeps it correct as the API drifts.

## 01 — COMPREHEND (Live)

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

Point Gecko at any OpenAPI — no provider help. A handful of intent-shaped tools. Auth resolved before a call goes out.

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

- Any OpenAPI — zero provider cooperation.
- Auth misdeclared in the spec caught at comprehension, not on a failed call.
- Credentials hidden from the agent — injected at call time.
- Unreachable operations filtered out before the agent sees them.

## 02 — SIMULATE (Live)

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

recorded mode synthesizes responses from the schema. $0, fully offline — correct before a live request goes out.

- Schema-generated responses — no network, no key, no spend.
- Same code path as live. Diverges only at the transport edge.
- Evaluate a paywalled API for $0 before subscribing.

## 03 — TEST (Live)

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

gecko test generates tests that assert the call matches the spec — run offline for $0.

- Green = first-call-correct. That's the whole assertion.
- Re-comprehend on drift — renamed field regenerates tools and tests. [Coming · V2]
- Tests are a pure function of the surface. Versionable, diffable.

## 04 — GO LIVE (Live)

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

One command. Credentials injected at call time — we're the control plane, never the data plane.

- Streamable-HTTP — one-click add to Claude or Cursor.
- Credentials injected at call time. Never custodied or logged.
- Control-plane only — we never see your response payloads.
- Re-comprehend instead of re-integrate when the API changes. [Coming · V2]

## For API providers

Own an API? See how Gecko makes it the one agents call right — and keeps it correct on every deploy: https://geckovision.tech/providers

## FOR AGENTS

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

HTML for humans. Markdown, manifest, and MCP endpoint for agents.

- [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/txline/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/txline/mcp
- PyPI: https://pypi.org/project/gecko-surf/
- Discord: https://discord.gg/3gVF5NNbCa
- Install: /plugin marketplace add GeckoVision/gecko-surf

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