Agent Control Plane Tools Reference

Each tool uses an action parameter to select the specific operation. All tools communicate via JSON-RPC 2.0 over the MCP endpoint at https://modelslab.com/mcp/agents.

Authentication

agent-auth

Authentication and account creation. Signup, login, forgot-password, reset-password, and resend-verification do not require a bearer token.

string

required

signup, login, logout, logout-all, forgot-password, reset-password, resend-verification

string

Email address (required for signup, login, forgot-password, reset-password, resend-verification)

string

Password (required for signup, login, reset-password)

string

Password confirmation (required for reset-password)

string

User name (optional for signup)

string

Device name for the token (optional for login, default: agent-control-plane)

string

Reset token (required for reset-password)

string

Token expiry: 1_week, 1_month (default), 3_months, never

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "agent-auth",
    "arguments": {
      "action": "login",
      "email": "agent@example.com",
      "password": "secret123",
      "token_expiry": "1_month"
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "agent-auth",
    "arguments": {
      "action": "signup",
      "email": "newuser@example.com",
      "password": "secret123",
      "name": "Agent Runner"
    }
  }
}

agent-tokens

Manage Sanctum access tokens. All actions require authentication.

string

required

list, revoke, revoke-others, switch-account

integer

Token ID (required for revoke)

string

Target team account username (required for switch-account)

string

Device name for new token (optional for switch-account)

string

Token expiry: 1_week, 1_month, 3_months, never

Profile & Account

agent-profile

Manage the authenticated user’s profile. All actions require authentication.

string

required

get, update, update-password, update-socials, update-preferences

string

Display name (for update)

string

Username (for update)

string

Bio/about text (for update)

string

Current password (required for update-password)

string

New password (required for update-password)

string

New password confirmation (required for update-password)

string

Facebook URL (for update-socials)

string

GitHub URL (for update-socials)

string

Twitter/X URL (for update-socials)

string

Instagram URL (for update-socials)

string

Discord handle (for update-socials)

boolean

Enable NSFW content (for update-preferences)

boolean

Enable wallet balance notifications (for update-preferences)

number

Wallet notification threshold amount (for update-preferences)

Get Profile Example

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "agent-profile",
    "arguments": {
      "action": "get"
    }
  }
}

API Keys

agent-api-keys

Manage API keys for generation endpoints (/api/v6, /api/v7, /api/v8). All actions require authentication.

string

required

list, create, get, update, delete

integer

API key ID (required for get, update, delete)

string

API key name (required for create, optional for update)

string

Notes about the API key (optional)

Create API Key Example

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "agent-api-keys",
    "arguments": {
      "action": "create",
      "name": "production-key"
    }
  }
}

Usage & Analytics

agent-usage

View API usage analytics. All actions require authentication.

string

required

summary, products, history

string

Start date filter, YYYY-MM-DD (optional for history)

string

End date filter, YYYY-MM-DD (optional for history)

integer

Max items to return, 1-200, default 100 (optional for history)

Model Discovery

agent-models

Search and discover 50,000+ AI models. All actions require authentication. The detail action returns endpoint configurations with a parameters JSON Schema object describing each endpoint’s accepted parameters (types, constraints, defaults, enums) alongside the raw config array, making it easy for agents to understand what parameters an endpoint accepts without parsing UI widget definitions.

string

required

search, filters, tags, providers, detail

string

Model ID (required for detail)

string

Search query (for search)

string

Filter by feature: imagen, video_fusion, audio_gen, llmaster, etc.

string

Filter by provider name

string

Filter by model type

string

Filter by model subcategory

string

Filter by base model

string

Comma-separated tags to filter by

string

Sort: recommended (default), newest, popular

integer

Results per page (default: 20)

Search Models Example

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "agent-models",
    "arguments": {
      "action": "search",
      "search": "flux",
      "feature": "imagen",
      "sort": "recommended",
      "per_page": 10
    }
  }
}

Billing & Payments

agent-billing

Manage billing, payment methods, and invoices. All actions require authentication.

string

required

overview, payment-methods, add-payment-method, set-default-payment-method, remove-payment-method, billing-info, update-billing-info, invoices, invoice-detail, invoice-pdf

string

Stripe payment method ID (for add/set-default/remove-payment-method)

boolean

Make the payment method default (for add-payment-method, default: true)

string

Billing name (for update-billing-info)

string

Billing email (for update-billing-info)

string

Tax ID value (for update-billing-info)

string

Tax ID type, e.g. eu_vat, us_ein (required with tax_id)

string

Address line 1 (for update-billing-info)

string

Address line 2 (for update-billing-info)

string

City (for update-billing-info)

string

State/province (for update-billing-info)

string

Postal/zip code (for update-billing-info)

string

Country code (for update-billing-info)

string

Invoice ID (for invoice-detail, invoice-pdf)

Wallet

agent-wallet

Manage wallet balance, auto-recharge, and coupons. All actions require authentication.

string

required

fund, auto-funding, disable-auto-funding, withdraw, validate-coupon, redeem-coupon

number

Amount in USD (required for fund, withdraw)

string

Stripe payment method ID (optional for fund — charges immediately; required for bonus coupon redeem)

number

Auto charge amount, min $5 (required for auto-funding)

number

Balance threshold to trigger auto charge, min $1 (required for auto-funding)

string

Coupon code (required for validate-coupon, redeem-coupon)

number

Purchase amount for bonus coupons (optional for validate-coupon, required for bonus coupon redeem)

Fund Wallet Example

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "agent-wallet",
    "arguments": {
      "action": "fund",
      "amount": 50,
      "payment_method_id": "pm_..."
    }
  }
}

Subscriptions

agent-subscriptions

Manage subscriptions. All actions require authentication. Use list-plans first to discover available subscription plans and pay-as-you-go options.

string

required

list-plans, list, create, update, pause, resume, reset-cycle, charge-amount, fix-payment

integer

Subscription ID (required for update, pause, resume, reset-cycle, fix-payment)

integer

Plan ID (required for create)

integer

New plan ID (required for update)

string

Redirect URL after successful checkout (optional for create)

string

Redirect URL if checkout is cancelled (optional for create)

number

Charge amount, $5-$10000 (required for charge-amount)

string

Plan category: enterprise, imagen, addon, normal

string

Stripe subscription ID override

Teams

agent-teams

Manage team members and invites. All actions require authentication.

string

required

list, create, get, update, delete, resend-invite, accept-invite

integer

Team member ID (required for get, update, delete, resend-invite)

string

Invite UUID (required for accept-invite)

string

Email address to invite (required for create)

string

Member role (for update)

array

Permissions array (for update)

string

Invite status: pending, accepted (for update)

Invite Team Member Example

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "agent-teams",
    "arguments": {
      "action": "create",
      "email": "teammate@example.com"
    }
  }
}

Get Started

MCP Web API

Agents API (Control Plane)

Client SDKs

Guides

Agent Control Plane Tools Reference

Authentication

agent-auth

agent-tokens

Profile & Account

agent-profile

API Keys

agent-api-keys

Usage & Analytics

agent-usage

Model Discovery

agent-models

Billing & Payments

agent-billing

Wallet

agent-wallet

Subscriptions

agent-subscriptions

Teams

agent-teams