MCP FactoryMCP FactoryDocs
HomeGitHubGet Started

API Reference

Direct API access to MCP Factory services.

Base URL

https://api.mcpfactory.org

Authentication

All requests require your MCP Factory API key in the header:

curl https://api.mcpfactory.org/campaigns \
  -H "Authorization: Bearer mcpf_your_api_key"

Endpoints

Campaigns

MethodEndpointDescription
POST/campaignsCreate a new campaign
GET/campaignsList all campaigns
GET/campaigns/:idGet campaign details
POST/campaigns/:id/pausePause a campaign
POST/campaigns/:id/resumeResume a campaign

Usage & Stats

MethodEndpointDescription
GET/usageGet your usage stats
GET/benchmarksGet community benchmarks

BYOK Keys

MethodEndpointDescription
GET/keysList configured BYOK keys
PUT/keys/:providerUpdate a BYOK key
DELETE/keys/:providerRemove a BYOK key

Rate Limits

PlanRate Limit
Free100 requests/minute
Pro1,000 requests/minute

Errors

All errors return a JSON response with an error message:

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid API key"
  }
}