Skip to main content

​
What is the Agent Control Plane MCP Server?

The Agent Control Plane MCP server lets AI agents manage a full ModelsLab account lifecycle without a browser. It exposes the Agents API (Control Plane) as MCP tools covering authentication, profile management, API keys, usage analytics, model discovery, billing, wallet, subscriptions, teams, training, servers, and uploads. This is separate from the Generation MCP server which handles image/video/audio/LLM generation. Together, these two servers give an AI agent complete access to ModelsLab.

Generation Server

Image, video, audio, LLM generation (24 tools). Auth: API key.

Control Plane Server

Account management (10 tools). Auth: Bearer token.

​
Endpoint

https://modelslab.com/mcp/agents

​
Authentication

The Agent Control Plane uses Sanctum bearer tokens (not API keys). Unauthenticated actions like signup and login work without a token.

​
Getting a Token

Use the agent-auth tool with the login action to get a bearer token: 
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "agent-auth",
    "arguments": {
      "action": "login",
      "email": "you@example.com",
      "password": "your-password"
    }
  }
}
The response includes an access_token to use for all subsequent requests.
You do not need to install anything. The server is hosted — just configure your IDE with the URL and token. See Agent Integration for setup guides.

​
Available Tools

ToolActionsDescription
agent-authsignup, login, logout, logout-all, forgot-password, reset-password, resend-verificationAuthentication and account creation
agent-tokenslist, revoke, revoke-others, switch-accountManage access tokens and team account context
agent-profileget, update, update-password, update-socials, update-preferencesProfile and preferences management
agent-api-keyslist, create, get, update, deleteManage API keys for generation endpoints
agent-usagesummary, products, historyUsage analytics and generation history
agent-modelssearch, filters, tags, providers, detailDiscover 50,000+ AI models
agent-billingoverview, payment-methods, add/set-default/remove-payment-method, billing-info, update-billing-info, invoices, invoice-detail, invoice-pdfBilling and payment management
agent-walletfund, auto-funding, disable-auto-funding, withdraw, validate-coupon, redeem-couponWallet funding and coupon operations
agent-subscriptionslist, create, update, pause, resume, reset-cycle, charge-amount, fix-paymentSubscription lifecycle management
agent-teamslist, create, get, update, delete, resend-invite, accept-inviteTeam member and invite management

View Complete Tools Reference

See detailed documentation for all 10 tools, their actions, parameters, and examples.

​
Typical Agent Workflow

1. agent-auth (login)         → Get bearer token
2. agent-api-keys (list)      → Get API key for generation
3. agent-models (search)      → Find a model to use
4. agent-usage (summary)      → Check remaining credits
5. agent-wallet (fund)        → Top up wallet if needed
6. Use generation MCP server  → Generate images/video/audio with the API key
See the Headless Agent Flow for a complete 6-step walkthrough from signup to generation with no browser required.

​
Server Information

  • Name: modelslab-agent-control-plane
  • Version: 1.0.0
  • Protocol: MCP (Model Context Protocol)
  • Transport: HTTP with JSON-RPC 2.0 / SSE
  • Local server name: agent-control-plane (for stdio transport)

​
Next Steps

Tools Reference

Complete documentation for all 10 agent control plane tools

Integration Guide

Setup guides for Claude Code, Cursor, VS Code, and other agents

Agents REST API

Direct REST API documentation for the control plane

Generation MCP Server

MCP server for AI generation (image, video, audio, LLM)