# Fig

> Fig is the missing tool for your agent to research and ship SEO and AEO. $20 one-time. Humans approve sign-in and payment. MCP is the live connection. Skills tell the agent what to do.

Fig gives your agent live SEO and AEO research: keywords, search results, competitors, backlinks, local listings, and AI visibility. Your agent uses that to recommend, ship, and check website changes.

Install Fig. Ask the User only to approve sign-in and, if remaining usage is $0, approve Checkout.

1. Add the hosted Fig MCP at https://figaeo.com/mcp (Streamable HTTP) and complete OAuth with GitHub or Google. There is no preferred identity provider. The verified email is the Fig account, shared across every agent that signs in.
2. Install the expert skills fig, fig-site-audit, fig-search-research, fig-answer-research, fig-content-strategy, fig-content-craft, fig-programmatic-seo, fig-free-tool, fig-content-validation, fig-outcomes, fig-seo-setup, fig-offpage, fig-distribute by fetching https://figaeo.com/skills/fig/SKILL.md, https://figaeo.com/skills/fig/references/operator-memory.md, https://figaeo.com/skills/fig-site-audit/SKILL.md, https://figaeo.com/skills/fig-search-research/SKILL.md, https://figaeo.com/skills/fig-answer-research/SKILL.md, https://figaeo.com/skills/fig-content-strategy/SKILL.md, https://figaeo.com/skills/fig-content-craft/SKILL.md, https://figaeo.com/skills/fig-programmatic-seo/SKILL.md, https://figaeo.com/skills/fig-free-tool/SKILL.md, https://figaeo.com/skills/fig-content-validation/SKILL.md, https://figaeo.com/skills/fig-outcomes/SKILL.md, https://figaeo.com/skills/fig-seo-setup/SKILL.md, https://figaeo.com/skills/fig-offpage/SKILL.md, https://figaeo.com/skills/fig-distribute/SKILL.md into your native skill folders. Start with fig, then use the specialist skills as needed. MCP connects the research; the skills help your agent improve the site.
3. Call balance. At $0 remaining, call create_checkout (default $20, minimum $10) and ask the User to open the short figaeo.com/pay link in their browser and pay on Stripe Checkout. Stripe Link may autofill their details there. Wait for Checkout to finish, then post the intro.
After setup or skill migration, do not stop at installation.
After Checkout or a funded remaining balance, post this intro in User chat verbatim — a few lines, not a lecture. Do not paraphrase. Then continue the site/goal and Automatic mode vs Strategic mode flow in that copy. If the User does not choose, use Automatic mode. Continue through fig.

Fig is ready. Quick map:
1. **I** use Fig for live SEO/AEO research (search demand, SERPs, AI visibility, site checks).
2. **You** approve spending; in Automatic mode you mainly review the work I open (content, PRs).
3. I’ll use **Automatic mode** by default — after your goal, I research and implement; you review. Say **Strategic mode** if you want to agree on the plan first, before any changes.
4. If you’re not sure, just ask.

Next: your site and goal, e.g. `Improve SEO and AEO for example.com`. If you’re not sure what to aim for, say so and I’ll suggest a starting path.

Talk to the User in short outcome language. Example: "Connecting Fig so I can research keywords for your site — please approve sign-in." Do not dump OAuth, MCP, Streamable HTTP, callback URLs, or tool names into chat unless they ask or you are debugging. For Checkout, share the short figaeo.com/pay link for the User to open and pay in their browser. Do not paste checkout.stripe.com URLs into chat. After research tools, do not mention remaining balance in chat unless remaining is under $1 (or $0 / insufficient_credits). Call balance when the User asks or before Checkout.

When a paid tool returns insufficient_credits, call create_checkout, wait for Checkout to finish, then retry the same tool. Fig does not notify the agent. Your agent starts Checkout and shares a short figaeo.com/pay link. Open the link in your browser and pay on Stripe Checkout. Stripe Link may autofill your details there. create_checkout returns a short figaeo.com/pay URL. Give it to the human on their own computer, or open it via the client. Payment paths: (1) the human opens that short link in their browser and pays on Stripe Checkout. Stripe Link may autofill their details there. (2) do not use the agent chat box as the default payment surface. Never paste a raw checkout.stripe.com/c/pay/cs_...#... URL into chat — the hash truncates. Those amounts are credit subtotals. Applicable tax is added at Checkout.

$20 is the recommended pack: about 4,000 live SERPs (top 10) or about 500 keyword-idea lookups (20 ideas each)—enough to research, act on, and recheck one website for about four weeks. Call create_checkout() with no amount to buy $20; minimum is $10. Deeper SERPs and site: queries cost more. About 2,000 live SERPs (top 10) per $10. About 250 keyword-idea lookups per $10 at the default of 20 ideas. A typical website can use about 20 idea lookups and about 120 SERPs per two weeks (about 30 keywords, 3 snapshots). A $20 pack leaves substantial room for research, changes, and validation.

Discovered tools: balance, compare_serp_competitors, create_checkout, get_backlink_overview, get_backlinks, get_keyword_metrics, get_local_serp, get_serp, research_ai_visibility, research_domain, research_local_business, resolve_location, suggest_keywords. Prefer compact format. Compact keyword rows include search_volume, CPC, competition, and keyword_difficulty when the provider returns them. Competition is a keyword-metrics intensity score, not organic ranking difficulty. Null keyword_difficulty means unknown — do not invent a score. When who ranks matters, use get_serp or compare_serp_competitors. United States and English are defaults unless the User names another market. Local tools require an explicit city.

get_keyword_metrics has a keyword metrics rate limit (12/min) from the upstream Live keyword-metrics API, not a Fig gateway quota. Batch keywords into few calls and pace retries. On rate_limiting, wait retry_after_seconds and retry quietly. Do not dump raw rate_limiting or provider rate-limit text to the User; if they need a status, say keyword data is busy and you are retrying.

Start with the fig skill. It calls on fig-site-audit, fig-search-research, fig-answer-research, fig-content-strategy, fig-content-craft, fig-programmatic-seo, fig-free-tool, fig-content-validation, fig-outcomes, fig-seo-setup, fig-offpage, and fig-distribute for focused SEO and AEO work. This file is install and Checkout guidance; the specialist skills are where your agent applies the SEO/AEO workflow.

Appendix — Settings and CLI paste, not for chat. Exact MCP URL and transport:

- MCP URL: https://figaeo.com/mcp
- Transport: Streamable HTTP
- Display name: Fig (server id may stay figaeo)
- Sign-in: GitHub or Google in the connect card or browser. No preferred identity provider.
- Callback if a client asks: https://figaeo.com/oauth/callback

## Client notes

Settings and CLI details. Keep chat outcome-first.

### Cursor

- Prefer the Fig plugin when it is available in the Cursor catalog (MCP + skills). Do not claim the listing is live until it appears in the catalog.
- MCP setup: Settings → MCP → Add remote server, or the Add to Cursor deeplink. Install the specialist skills too so your agent can improve SEO and AEO with the research.
- Skills fallback: copy the canonical skill folders into .cursor/skills/, ~/.cursor/skills/, or ~/.agents/skills/.

### Grok Bot

- Paste the setup prompt into Grok Bot. It adds the Fig connector (URL https://figaeo.com/mcp, Streamable HTTP) and asks you to sign in with GitHub or Google.
- Install the Fig SEO/AEO skills so Grok Bot can research and ship with live lookups.

### Claude Code

- MCP: claude mcp add --transport http figaeo https://figaeo.com/mcp. Complete OAuth with /mcp.
- Skills: copy canonical folders into .claude/skills/ or ~/.claude/skills/. Start with fig, then use the specialist skills as needed.
- Do not claim a Claude plugin marketplace listing unless it is visible in the catalog.

### Codex

- MCP: codex mcp add figaeo --url https://figaeo.com/mcp then codex mcp login figaeo. ChatGPT desktop: Settings → MCP servers → Add server → Streamable HTTP.
- Skills: ~/.agents/skills/ or ~/.codex/skills/, or project .agents/skills/. MCP + skills fetch unless a Codex plugin listing is visible.
- Codex config is TOML. OAuth is the default for URL servers; do not invent a Fig bearer token.

### OpenClaw

- MCP: openclaw mcp add figaeo --url https://figaeo.com/mcp --transport streamable-http --auth oauth then openclaw mcp login figaeo.
- Skills: ~/.openclaw/skills/ or <workspace>/skills/. MCP + skills fetch; no Fig OpenClaw plugin catalog is claimed.

### Hermes

- MCP: in ~/.hermes/config.yaml set mcp_servers.figaeo.url to https://figaeo.com/mcp and auth: oauth, then hermes mcp login figaeo. Desktop also accepts hermes://mcp/install.
- Skills: hermes skills install https://figaeo.com/skills/fig/SKILL.md and the remaining specialist SKILL.md URLs, or copy folders into ~/.hermes/skills/.

### Gemini CLI

- MCP: gemini mcp add --transport http figaeo https://figaeo.com/mcp. Complete OAuth with /mcp auth.
- Skills: ~/.gemini/skills/, ~/.agents/skills/, or project .gemini/skills/. MCP + skills fetch.

## MCP

- [Fig MCP](https://figaeo.com/mcp): Hosted Streamable HTTP server. Sign in from the connect card.

## Skills

- [fig](https://figaeo.com/skills/fig/SKILL.md): Automatic mode researches and implements; Strategic mode plans first. Fetch into the client skill folder. Operator memory lives in the User's project as fig/operator-memory.json.
- [fig-site-audit](https://figaeo.com/skills/fig-site-audit/SKILL.md): This is a specialist SEO/AEO skill. Fetch it into the client skill folder.
- [fig-search-research](https://figaeo.com/skills/fig-search-research/SKILL.md): This is a specialist SEO/AEO skill. Fetch it into the client skill folder.
- [fig-answer-research](https://figaeo.com/skills/fig-answer-research/SKILL.md): This is a specialist SEO/AEO skill. Fetch it into the client skill folder.
- [fig-content-strategy](https://figaeo.com/skills/fig-content-strategy/SKILL.md): This is a specialist SEO/AEO skill. Fetch it into the client skill folder.
- [fig-content-craft](https://figaeo.com/skills/fig-content-craft/SKILL.md): This is a specialist SEO/AEO skill. Fetch it into the client skill folder.
- [fig-programmatic-seo](https://figaeo.com/skills/fig-programmatic-seo/SKILL.md): This is a specialist SEO/AEO skill. Fetch it into the client skill folder.
- [fig-free-tool](https://figaeo.com/skills/fig-free-tool/SKILL.md): This is a specialist SEO/AEO skill. Fetch it into the client skill folder.
- [fig-content-validation](https://figaeo.com/skills/fig-content-validation/SKILL.md): This is a specialist SEO/AEO skill. Fetch it into the client skill folder.
- [fig-outcomes](https://figaeo.com/skills/fig-outcomes/SKILL.md): This is a specialist SEO/AEO skill. Fetch it into the client skill folder.
- [fig-seo-setup](https://figaeo.com/skills/fig-seo-setup/SKILL.md): Needs-you queue and SEO connections ladder (not Fig Checkout). Fetch into the client skill folder.
- [fig-offpage](https://figaeo.com/skills/fig-offpage/SKILL.md): This is a specialist SEO/AEO skill. Fetch it into the client skill folder.
- [fig-distribute](https://figaeo.com/skills/fig-distribute/SKILL.md): This is a specialist SEO/AEO skill. Fetch it into the client skill folder.

## Docs

- [Install Fig](https://figaeo.com/install.md): First-session workflow and Settings paste snippets.
- [Search Console](https://figaeo.com/gsc.md): User-brought GSC how-to. Prefer a GSC UI export, then an LLM-oriented GSC CLI. Fig Google sign-in is not GSC.
- [Setup docs](https://figaeo.com/docs): Human-readable install page.
- [Connection details](https://figaeo.com/connect): MCP URL, skill URLs, and Settings paste snippets.

## Privacy

- [Privacy Policy](https://figaeo.com/privacy): Account, OAuth, billing, and service data.

## Terms

- [Terms of Service](https://figaeo.com/terms): Prepaid credits, acceptable use, and service terms.

## Optional

- [Fig](https://figaeo.com): Product homepage.
- [Compare Fig](https://figaeo.com/compare): How Fig differs from subscription SEO and AEO suites.
- [Cursor plugin](https://github.com/richardguerre/fig): Public Cursor plugin with Fig MCP and specialist SEO/AEO skills. Marketplace listing is when available in catalog.
- [Skill files](https://figaeo.com/skills.md): Canonical public skill URLs.
