Using Bittlebits with AI Agents Through Model Context Protocol (MCP)

Bittlebits has a Model Context Protocol (MCP) integration that lets you bring your GEO scores and rewrite suggestions directly into AI agents — whether you're using Claude Code in your terminal, GitHub Copilot in your IDE, or an AI web app, instead of copying content back and forth, AI can read exactly what Bittlebits recommends and help you apply those changes, including writing them directly into your codebase.

---

What you can do

Once connected, you can ask your agent things like:

• "Show me what Bittlebits wants to change on this page and explain why."
• "Rewrite my homepage copy applying the Bittlebits suggestions."
• "Which metrics are weakest and what should I fix first?"
• "Help me apply suggestion #3 without changing the tone."
• "Get the score for my landing page, then find and update the file in my codebase."

---

Step 1 — Connect An Agent

Bittlebits uses OAuth for MCP. When you first use a Bittlebits tool, your client will open a browser window to sign in to your Bittlebits account.

Claude Code (CLI)

Run this once in your terminal:

claude mcp add --transport http bittlebits https://bittlebits.ai/mcp

The first time you invoke a Bittlebits tool, Claude Code will open your browser to complete sign-in. Claude can now pull your scores and rewrites, then find and edit the right files in your codebase directly.

Claude.ai Web App or Claude Desktop

Navigate to Settings > Connectors and click Add custom connector.

1. Give the MCP connection a name such as "Bittlebits"
2. For Remote MCP server URL, enter https://bittlebits.ai/mcp
3. Ignore the advanced settings and click Connect.
4. Complete the login to establish a connection between Claude and your BittleBits account.

Visual Studio Code

For availability across all your projects, create an mcp.json in ~/.vscode/mcp.json (macOS) or %USERPROFILE%.vscode\mcp.json (Windows). For project specific availability, create the mcp.json file in the .vscode directory of your project root.

{
  "servers": {
    "bittlebits": {
      "url": "https://bittlebits.ai/mcp"
    }
  }
}

Then follow the OAuth pop up to link the MCP client to your BittleBits account.

Other clients

Any MCP-compatible client that supports HTTP transport and OAuth 2.0 will work. Point it at https://bittlebits.ai/mcp.

---

Step 2 — Start a conversation

With the MCP connected, open a new chat and try:

"Use the Bittlebits tool to get the rewrite suggestions for example.com, then help me apply them in my codebase."

Your agent will pull the original and rewritten content from Bittlebits, analyze your codebase, and walk you through the changes on the appropriate page.

For scoring context:

"Get the scores for example.com and tell me which areas need the most improvement."

---

Available tools

Tool	What it does
get_score	Returns GEO metric scores (0–10 per dimension) for a page
get_rewrite	Returns your original page content and a rewritten version with Bittlebits suggestions applied

---

Tips

• Be specific about what to keep. If your brand voice matters, tell your agent: "Apply the suggestions but keep the casual, conversational tone."
• Work section by section on longer pages — it's easier to review that way.
• Re-score after edits. Once you've updated your page, trigger a new Bittlebits score to see how much the metrics improved.