Abliteration MCP

@abliteration/mcp

An MCP server that gives AI agents - Claude Code, Claude Desktop, Cursor, Windsurf and any other MCP host - direct access to the abliteration.org public API. Your agent can search the catalog of abliterated and uncensored LLMs, read the M-code method taxonomy, look up authors, datasets and indices, and follow the change streams Hugging Face doesn't offer: delisted models, the 24-month deletion record, README drift history and download anomalies. Every call is billed in credits from your abliteration.org wallet, and every result starts with a cost: 5 cr · balance: 704 cr line, so the agent can tell you what it spent.

You need an API key from abliteration.org/api. The key looks like abl_live_....

Install

Claude Desktop

Add this to claude_desktop_config.json (Settings → Developer → Edit Config):

{
  "mcpServers": {
    "abliteration": {
      "command": "npx",
      "args": ["-y", "@abliteration/mcp"],
      "env": {
        "ABLITERATION_API_KEY": "abl_live_..."
      }
    }
  }
}

Claude Code

claude mcp add abliteration -e ABLITERATION_API_KEY=abl_live_... -- npx -y @abliteration/mcp

Cursor

Add this to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project):

{
  "mcpServers": {
    "abliteration": {
      "command": "npx",
      "args": ["-y", "@abliteration/mcp"],
      "env": {
        "ABLITERATION_API_KEY": "abl_live_..."
      }
    }
  }
}

Windsurf

Add this to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "abliteration": {
      "command": "npx",
      "args": ["-y", "@abliteration/mcp"],
      "env": {
        "ABLITERATION_API_KEY": "abl_live_..."
      }
    }
  }
}

You can pass the key as "args": ["-y", "@abliteration/mcp", "--api-key", "abl_live_..."] instead of using env. The flag wins if both are set.

Tools

Each tool maps to one API route and takes that route's query parameters, with the same names. The credit cost is listed in each tool's description, so the agent sees it before calling.

Catalog

Change streams

Every result has a cost line, then the server's full JSON envelope:

cost: 5 cr · balance: 704 cr

{
  "data": [ ... ],
  "cost": 5,
  "credits_remaining": 704,
  "rate_limit_limit": ...,
  "rate_limit_remaining": ...,
  "rate_limit_reset": ...,
  "metering": "billed",
  "request_id": "..."
}

Pricing

The tools spend the same credit wallet as the abliteration.org Research Agent. Most routes cost 1-20 credits. get_timeline costs 50 credits. search_models gets more expensive for large pages and deep offsets. For the full terms, see abliteration.org/terms, section 7 ("Credits and payments"). For the per-route price table, see abliteration.org/api.

Troubleshooting

"Invalid or missing ABLITERATION_API_KEY": the key is missing, mistyped or revoked. Check the env block in your host config, then restart the host. The server still starts without a key, but every tool call returns this message.

"Out of credits": the call costs more credits than your balance. Top up at abliteration.org/shop/pricing. The welcome credits you get at signup work only with the Research Agent, not with the API.

Pointing at a local or staging server: set ABLITERATION_API_BASE:

"env": {
  "ABLITERATION_API_KEY": "abl_test_...",
  "ABLITERATION_API_BASE": "http://localhost:4321/api/v1"
}

The bare host (http://localhost:4321) also works. That's the form the abl CLI uses, and /api/v1 is added for you.

Debug logging: set DEBUG=abl:*. Every request, status and timing is logged to stderr, which MCP hosts write to their server log. To log only HTTP traffic, use DEBUG=abl:http. Logging never goes to stdout, because stdout carries the MCP protocol.

Checking the server end to end (from a checkout, in mcp/):

npm install
npm run build
ABLITERATION_API_KEY=abl_live_... node scripts/smoke.mjs   # one live list_methods call, 5 credits
node scripts/smoke.mjs --offline                           # handshake and tool list only, no key needed

License

MIT © Catyonic OÜ