Skip to main content
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.
action
string
required
signup, login, logout, logout-all, forgot-password, reset-password, resend-verification
email
string
Email address (required for signup, login, forgot-password, reset-password, resend-verification)
password
string
Password (required for signup, login, reset-password)
password_confirmation
string
Password confirmation (required for reset-password)
name
string
User name (optional for signup)
device_name
string
Device name for the token (optional for login, default: agent-control-plane)
token
string
Reset token (required for reset-password)
token_expiry
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.
action
string
required
list, revoke, revoke-others, switch-account
token_id
integer
Token ID (required for revoke)
account_username
string
Target team account username (required for switch-account)
device_name
string
Device name for new token (optional for switch-account)
token_expiry
string
Token expiry: 1_week, 1_month, 3_months, never

Profile & Account

agent-profile

Manage the authenticated user’s profile. All actions require authentication.
action
string
required
get, update, update-password, update-socials, update-preferences
name
string
Display name (for update)
username
string
Username (for update)
about_me
string
Bio/about text (for update)
current_password
string
Current password (required for update-password)
password
string
New password (required for update-password)
password_confirmation
string
New password confirmation (required for update-password)
facebook
string
Facebook URL (for update-socials)
github
string
GitHub URL (for update-socials)
twitter
string
Twitter/X URL (for update-socials)
instagram
string
Instagram URL (for update-socials)
discord
string
Discord handle (for update-socials)
nsfw_content
boolean
Enable NSFW content (for update-preferences)
wallet_notification_enabled
boolean
Enable wallet balance notifications (for update-preferences)
wallet_notification_threshold
number
Wallet notification threshold amount (for update-preferences)
{
  "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.
action
string
required
list, create, get, update, delete
key_id
integer
API key ID (required for get, update, delete)
name
string
API key name (required for create, optional for update)
notes
string
Notes about the API key (optional)
{
  "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.
action
string
required
summary, products, history
from
string
Start date filter, YYYY-MM-DD (optional for history)
to
string
End date filter, YYYY-MM-DD (optional for history)
limit
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.
action
string
required
search, filters, tags, providers, detail
model_id
string
Model ID (required for detail)
Search query (for search)
feature
string
Filter by feature: imagen, video_fusion, audio_gen, llmaster, etc.
provider
string
Filter by provider name
model_type
string
Filter by model type
model_subcategory
string
Filter by model subcategory
base_model
string
Filter by base model
tags
string
Comma-separated tags to filter by
sort
string
Sort: recommended (default), newest, popular
per_page
integer
Results per page (default: 20)
{
  "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.
action
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
payment_method_id
string
Stripe payment method ID (for add/set-default/remove-payment-method)
make_default
boolean
Make the payment method default (for add-payment-method, default: true)
name
string
Billing name (for update-billing-info)
email
string
Billing email (for update-billing-info)
tax_id
string
Tax ID value (for update-billing-info)
tax_id_type
string
Tax ID type, e.g. eu_vat, us_ein (required with tax_id)
address_line1
string
Address line 1 (for update-billing-info)
address_line2
string
Address line 2 (for update-billing-info)
address_city
string
City (for update-billing-info)
address_state
string
State/province (for update-billing-info)
address_postal_code
string
Postal/zip code (for update-billing-info)
address_country
string
Country code (for update-billing-info)
invoice_id
string
Invoice ID (for invoice-detail, invoice-pdf)

Wallet

agent-wallet

Manage wallet balance, auto-recharge, and coupons. All actions require authentication.
action
string
required
fund, auto-funding, disable-auto-funding, withdraw, validate-coupon, redeem-coupon
amount
number
Amount in USD (required for fund, withdraw)
payment_method_id
string
Stripe payment method ID (optional for fund — charges immediately; required for bonus coupon redeem)
auto_charge_amount
number
Auto charge amount, min $5 (required for auto-funding)
charge_threshold
number
Balance threshold to trigger auto charge, min $1 (required for auto-funding)
coupon_code
string
Coupon code (required for validate-coupon, redeem-coupon)
purchase_amount
number
Purchase amount for bonus coupons (optional for validate-coupon, required for bonus coupon redeem)
{
  "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.
action
string
required
list-plans, list, create, update, pause, resume, reset-cycle, charge-amount, fix-payment
subscription_id
integer
Subscription ID (required for update, pause, resume, reset-cycle, fix-payment)
plan_id
integer
Plan ID (required for create)
new_plan_id
integer
New plan ID (required for update)
success_url
string
Redirect URL after successful checkout (optional for create)
cancel_url
string
Redirect URL if checkout is cancelled (optional for create)
amount
number
Charge amount, 5−5-10000 (required for charge-amount)
plan_category
string
Plan category: enterprise, imagen, addon, normal
stripe_subscription_id
string
Stripe subscription ID override

Teams

agent-teams

Manage team members and invites. All actions require authentication.
action
string
required
list, create, get, update, delete, resend-invite, accept-invite
member_id
integer
Team member ID (required for get, update, delete, resend-invite)
invite_id
string
Invite UUID (required for accept-invite)
email
string
Email address to invite (required for create)
role
string
Member role (for update)
permissions
array
Permissions array (for update)
invite_status
string
Invite status: pending, accepted (for update)
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "agent-teams",
    "arguments": {
      "action": "create",
      "email": "teammate@example.com"
    }
  }
}