Using Bittlebits with Claude (or any AI assistant)

Bittlebits has a Model Context Protocol (MCP) integration that lets you bring your GEO scores and rewrite suggestions directly into Claude — whether you're using the Claude.ai web app, Claude Desktop, or Claude Code in your terminal. Instead of copying content back and forth, Claude 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 Claude 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." (Claude Code)

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. This is the most powerful integration — Claude can 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.

Give the MCP connection a name such as "Bittlebits"
For Remote MCP server URL, enter https://bittlebits.ai/mcp
Expand the Advanced settings
For OAuth Client ID, enter K6lNoobXrXNmxsXwzDOOfuARmwiWe6Ry5qJEpgMk
Leave the OAuth Client Secret blank

Claude.ai Add Custom Connector dialog showing Bittlebits MCP configuration

Cursor

Create an mcp.json in ~/.cursor/mcp.json (macOS) or %USERPROFILE%.cursor\mcp.json (Windows). These tools are available across all your projects.

{
  "mcpServers": {
    "oauth-server": {
      "url": "https://bittlebits.ai/mcp",
      "auth": {
        "CLIENT_ID": "K6lNoobXrXNmxsXwzDOOfuARmwiWe6Ry5qJEpgMk"
      }
    }
  }
}

Other clients

Any MCP-compatible client that supports HTTP transport and OAuth 2.0 will work. Point it at https://bittlebits.ai/mcp. If your client requires a client ID, use:

K6lNoobXrXNmxsXwzDOOfuARmwiWe6Ry5qJEpgMk

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."

Claude 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
`submit_url`	Submits a URL to Bittlebits for processing and returns its `url_id`
`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 Claude: "Apply the suggestions but keep the casual, conversational tone."
Work section by section on longer pages — it's easier to review that way.
Use Claude Code for implementation. After reviewing suggestions in the web app or Desktop, switch to Claude Code to have changes written directly into your project files.
Re-score after edits. Once you've updated your page, trigger a new Bittlebits score to see how much the metrics improved.