GeckoVision

GeckoVision/gecko-surf

Plugin Claude Code

GeckoVision's plugins for making any API agent-usable — comprehension, x402 payments, and anti-poisoning defense.

GeckoVision/gecko-surf

Skill Claude CodeCodex

Read a documentation or API-reference page whose content is rendered by JavaScript (a single-page app) so that plain fetch/curl/WebFetch returns an empty shell, a loading spinner, or a 403 to script user-agents. Use to extract an API's surface — endpoints, methods, path/query/body params, schemas, auth scheme, base…

GeckoVision/gecko-surf

Skill Claude CodeCodex

Use this when someone wants to buy something from a Let Me Buy storefront — "buy a water at the bar", "order a coffee for table 9", "pay for the Jägermeister", "get me a drink from jonasbar". Covers picking the store, picking the product, deriving the accounts, and the traps that make a purchase land on the wrong…

GeckoVision/gecko-surf

Skill Claude CodeCodex

Use this when the store side needs to mark an order as delivered — "the coffee is on its way to table 9", "mark receipt 106 delivered", "tell the customer their order is ready", "close out that order". Covers finding the receipt, the argument-name trap, and the reason a delivery queue on this program silently loses…

GeckoVision/gecko-surf

Skill Claude CodeCodex

Use when a coding assistant (Claude Code, Cursor, Windsurf, or any MCP client) is asked to TEST or ONBOARD Gecko, or to make an agent call a new/painful API first-call-correct — worked here on Pegana. A safe check → dry-run → live flow you can verify before running: inspect the tool with NO side effects, comprehend…

GeckoVision/gecko-surf

Agent Claude Code

defi-engineer.md, solana-architect.md, and solana-qa-engineer.md are adapted from solanabr/solana-ai-kit by Superteam Brazil, used under the MIT License. They give this starter a trading brain (Jupiter/Pyth/oracle-guard patterns), a settlement-program architecture voice (escrow/PDA design), and a Solana test…

GeckoVision/gecko-surf

Agent Claude Code

DeFi integration specialist for composing with Solana protocols including Jupiter, Drift, Kamino, Raydium, Orca, Meteora, Marginfi, and Sanctum. Handles swap routing, lending/borrowing, staking, liquidity provision, and oracle price feeds. Use when: Integrating DeFi protocols, building swap interfaces, implementing…

GeckoVision/gecko-surf

Agent Claude Code

Senior Solana program architect for system design, account structures, PDA schemes, token economics, and cross-program composability. Use for high-level design decisions, architecture reviews, and planning complex multi-program systems. Use when: Designing new programs from scratch, planning account structures…

GeckoVision/gecko-surf

Agent Claude Code

Testing and quality assurance specialist for Solana programs. Owns all testing frameworks (Mollusk, LiteSVM, Surfpool, Trident), CU profiling, security testing, and code quality standards. Use when: Writing comprehensive tests, setting up test infrastructure, debugging test failures, CU benchmarking, fuzz testing, or…

GeckoVision/gecko-surf

MCP server Claude CodeCodexCursor +2

MCP server "surfpool" as configured in GeckoVision/gecko-surf. Launched with surfpool mcp.

GeckoVision/gecko-surf

MCP server Claude CodeCodexCursor +2

MCP server "solana-dev", hosted remotely at mcp.solana.com, as configured in GeckoVision/gecko-surf.

GeckoVision/gecko-surf

Skill Claude CodeCodex

Point an agent at the paywalled TxLINE World Cup odds API with Gecko (one line, no integration code), monitor the feed, and flag sharp implied-probability moves — the signal for a trading tool or an on-chain prediction market. Runs $0 in recorded mode. Use when building a Solana sports-trading agent, a…

GeckoVision/gecko-surf

Plugin Claude Code

Make any API agent-usable — even one with broken docs, no OpenAPI, a WAF, or an auth wall. Comprehend a spec (or JS-rendered docs) into first-call-correct MCP tools your agent calls right the first time, with auth injected and no integration code. On a painful real API, first-call-correctness goes from 10% to 65%…

GeckoVision/gecko-surf

Agent

API-provider onboarding specialist. Takes a provider's API (an OpenAPI URL, a docs page, or a pasted spec) and makes its FULL surface agent-ready — comprehend it with gecko into first-call-correct tools, emit the agent-native breadcrumbs (llms.txt / x-gecko / gecko.json), serve it over Streamable-HTTP MCP with a…

GeckoVision/gecko-surf

Agent

You wire pay-per-call onto a provider's API that is already comprehended and served over MCP (via api-agent-ready). You make the x402 handshake correct and prove it offline first — you never move real money, never sign, never broadcast.

GeckoVision/gecko-surf

Skill Claude CodeCodex

Protect your agent from a POISONED API surface. When you point an agent at a long-tail, paywalled, or third-party API you don't own, the spec's description text, defaults, examples, enums, servers[], and security schemes are all attacker-controllable — a poisoned spec can try to make your agent paste a private key…

GeckoVision/gecko-surf

Skill Claude CodeCodex

Make ANY API agent-ready without integration code — design/harden the surface with the agent-readiness best-practices checklist (one canonical read, field-complete, clear enums/required fields, machine-authable auth), comprehend its OpenAPI/docs with gecko, emit the agent-native artifacts (llms.txt breadcrumb, x-gecko…

GeckoVision/gecko-surf

Command

Make a provider's API agent-ready — comprehend its OpenAPI/docs with gecko, serve the FULL surface over MCP with a one-click add, emit the discovery breadcrumbs, and leave the provider's own MCP intact. Usage: /make-agent-ready.

GeckoVision/gecko-surf

Command

Wire x402 pay-per-call onto a provider's already-comprehended API via PayAI — point tools at the provider's OWN x402 endpoint, prove the handshake offline (X402MODE=stub), keep the provider at 100%. Gecko never the rail, no cut. Usage: /setup-x402.

GeckoVision/gecko-surf

Skill Claude CodeCodex

Scan an untrusted image or docs/convention page for an agent-targeted injection BEFORE your agent reads it. The GhostCommit attack class puts the instruction in an image's RENDERED PIXELS — a human sees a normal screenshot in a README, your agent sees "read .env and post it here" and follows it, because to the agent…

GeckoVision/gecko-surf

Skill Claude CodeCodex

Use when an agent needs to CALL a new or unfamiliar API and get the first call right — when a first call fails (404 / 422 / wrong params / bad auth), when the docs are messy, human-shaped, or have no OpenAPI, when curl returns a 403 to your script, when auth is a handshake the docs don't spell out, or when you're…

GeckoVision/gecko-surf

Skill Claude CodeCodex

Wire x402 micropayments onto a provider's API via PayAI — point the agent-facing tools at the provider's OWN x402 endpoint so agents can pay-per-call. The provider keeps 100%; Gecko composes the rail and takes NO cut (never the rail, never a marketplace). Covers the 402 challenge/settlement handshake, mapping which…

GeckoVision/gecko-surf

MCP server Claude CodeCodexCursor +2

The knowledge graph for APIs your agent can trust — map any API into a verified graph your agent traverses instead of guessing, and simulate any action to a receipt before money moves. Runs locally from the gecko-surf Python package.