streamable-httpMITupdated 3mo ago
Connect Claude, Cursor, and any MCP-compatible AI agent to BittleBits — bringing your GEO (Generative Engine Optimization) scores and AI-content rewrite suggestions directly into your agent as tools.
What can you do with BittleBits GEO Assistant?
BittleBits MCP Plugin
Connect Claude, Cursor, and any MCP-compatible AI agent to BittleBits — bringing your GEO (Generative Engine Optimization) scores and AI-content rewrite suggestions directly into your agent as tools.
This repository is the installable plugin wrapper. The BittleBits MCP server itself is hosted and remote — it speaks Streamable HTTP and authenticates with OAuth 2.0, so there is no token to configure and nothing to run locally. Point your client at the server and sign in through your browser.
What you get
Once connected, your agent can call BittleBits tools to score and rewrite content without copy-pasting between tabs:
| 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 |
Ask things like "Get the BittleBits score for my landing page and tell me which areas need the most work," or "Rewrite my homepage applying the BittleBits suggestions but keep the casual tone."
Install
The server lives at https://bittlebits.ai/mcp. On first use, your client opens a browser window to sign in to your BittleBits account (OAuth) — no API keys or tokens to paste.
Claude Code (CLI)
claude mcp add --transport http bittlebits https://bittlebits.ai/mcp
Claude.ai / Claude Desktop
Settings → Connectors → Add custom connector, name it BittleBits, and set the remote MCP server URL to https://bittlebits.ai/mcp.
Cursor / VS Code
Add to your mcp.json:
{
"mcpServers": {
"bittlebits": {
"type": "http",
"url": "https://bittlebits.ai/mcp"
}
}
}
This repo's root .mcp.json contains exactly this config, so MCP-aware directories and clients can auto-detect the server.
Documentation
Full setup guide and examples: https://bittlebits.ai/docs/mcp
License
MIT © 2026 BittleBits.ai
Install
Add BittleBits GEO Assistant to your client. Pick the one you use.
claude mcp add --transport http bittlebits-geo-assistant https://bittlebits.ai/mcpcodex mcp add bittlebits-geo-assistant --url https://bittlebits.ai/mcp{
"mcpServers": {
"bittlebits-geo-assistant": {
"url": "https://bittlebits.ai/mcp"
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
{
"servers": {
"bittlebits-geo-assistant": {
"type": "http",
"url": "https://bittlebits.ai/mcp"
}
}
}Add to `.vscode/mcp.json` in your workspace.
{
"mcpServers": {
"bittlebits-geo-assistant": {
"url": "https://bittlebits.ai/mcp"
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"bittlebits-geo-assistant": {
"serverUrl": "https://bittlebits.ai/mcp"
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
Score
39 / 100
Incomplete
- Documentation22/25
- Maintenance13/25
- Trust16/20
- Capability0/15
- Install experience12/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 90 days ago
- Has a release history
- Repository is not archived
- Licensed MIT
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 0 tool(s) documented
- Provides prompt templates
- Provides resources
- 6 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint — no local install
Version history
| Versions | Published |
|---|---|
| 1.0.0Latest | Jun 2, 2026 |