MCP server

Manage projects, API keys, policies, and usage from your AI assistant.

Connect

Sign in with your Abliteration account and choose an organization. No API key is required.

Codex

codex mcp add abliteration --url \
  https://api.abliteration.ai/mcp
codex mcp login abliteration

Complete sign-in in your browser, then start a new Codex conversation. Run /mcp in the Codex CLI to check the connection.

Claude Code

claude mcp add --transport http \
  --scope user abliteration \
  https://api.abliteration.ai/mcp

Open Claude Code, run /mcp, and select abliteration to sign in.

Claude

1. Open Customize > Connectors and select Add > Add custom connector.
2. Name it Abliteration and enter this server URL:

https://api.abliteration.ai/mcp

3. Complete OAuth sign-in and enable the connector in your conversation.

On managed plans, an administrator may need to add the connector first. See Claude’s connector setup.

Cursor

Add this entry to ~/.cursor/mcp.json, alongside any existing servers:

{
  "mcpServers": {
    "abliteration": {
      "url": "https://api.abliteration.ai/mcp"
    }
  }
}

Enable abliteration in Cursor’s MCP settings and sign in. The tools are available in Agent chat.

Try it

List my Abliteration projects.

Tools

Organization and projects

Tool	Action
retrieve_organization	Read the connected organization’s details
list_projects	List projects
retrieve_project	Read a project
create_project	Create a project
update_project	Update a project
archive_project	Archive a project

API keys

Tool	Action
list_project_api_keys	List a project’s API keys
retrieve_project_api_key	Read a Project API key’s metadata
create_project_api_key	Create a Project API key
delete_project_api_key	Revoke a Project API key
list_admin_api_keys	List Admin API keys
retrieve_admin_api_key	Read an Admin API key’s metadata
create_admin_api_key	Create an Admin API key
delete_admin_api_key	Revoke an Admin API key

Policies

Tool	Action
list_policies	List policies
retrieve_policy	Read a policy
create_policy	Create a policy draft
update_policy	Update a policy draft
publish_policy	Publish a policy draft
pause_policy	Pause a policy
resume_policy	Resume a policy
delete_policy	Delete a policy
list_policy_versions	List published policy versions
retrieve_policy_version	Read a published policy version
list_effective_policies	List a project’s active policies

Spend limits

Tool	Action
retrieve_organization_spend_limit	Read the organization spend limit
update_organization_spend_limit	Set the organization spend limit
delete_organization_spend_limit	Remove the organization spend limit
retrieve_project_spend_limit	Read a project’s spend limit
update_project_spend_limit	Set a project’s spend limit
delete_project_spend_limit	Remove a project’s spend limit

Usage and billing

Tool	Action
retrieve_organization_balance	Read the prepaid balance
retrieve_organization_usage_completions	Read completion usage
retrieve_organization_costs	Read costs

Authentication

The connection uses your current role in the organization you selected at sign-in. Review tool calls before approving changes.

Permissions by role

Role	Access
Owner or admin	All management tools
Billing	Read organization details, projects, balances, usage, costs, and spend limits; manage spend limits
Other members	Read organization details and projects

Creating an API key returns a secret. Store it securely and keep it out of shared conversations.

Reconnect or change organizations

Your client refreshes authorization to keep you connected. If authorization expires, sign in again. To change organizations, reconnect and select the organization you want to use.

Rate limits

If a request is rate-limited, wait for the delay in Retry-After or the tool error’s retry_after_seconds before retrying.

Default request limits per minute

Each management call counts against both your user budget and the shared organization budget.

Operation	Per user	Per organization
Reads	120	600
Usage and cost queries	30	120
Changes, including Project API keys	30	100
Admin API-key creation and revocation	10	30

Up to 5 management calls can run concurrently per user and 20 per organization. The MCP endpoint also limits requests to 300 per minute per IP address. Additional connection limits can restrict bursts.

Organization budgets are shared with Administration API calls. Signing in again or using another client does not reset your user budget.

Model-inference request and token limits are separate. See API rate limits.

Retry a request

• Honor the retry delay. If none is provided, use exponential backoff with jitter.
• Cap retry attempts and total retry time.
• For changes, reuse the original idempotencyKey where supported. Do not automatically retry an operation whose result is uncertain.

Troubleshooting

Cannot connect

Use https://api.abliteration.ai/mcp and enable the server in your client. The client must support remote MCP over Streamable HTTP and OAuth.

Sign-in required or 401

Reconnect through your client’s OAuth sign-in flow.

Permission denied or 403

Check the connected organization and ask an owner or admin to confirm your role.

Resource not found

Check the resource ID. If you connected to a different organization, reconnect and select the organization that owns the resource.