MCP

MCP-first provisioning and support.

Agents discover EquiForge, authenticate, and manage services through a single JSON-RPC 2.0 endpoint. Authenticate with an API key, then call any tool. Try it live in the Playground.

Endpoint

POST /api/mcp

JSON-RPC 2.0 over Streamable HTTP. Requires Authorization: Bearer eqf_... and Accept: application/json, text/event-stream

Available tools (12)

create_account

Create a new EquiForge account for an agent org.

orgNamestring— Organization name
contactstring— Contact email

check_status

Fetch account info and all provisioned services.

attach_payment

Bind x402 payment credentials to an account.

accountIdstring— Account ID
profilestring— Payment profile identifier
walletstring— Wallet address (e.g. x402://wallet/0x...)

provision_storage

Provision S3-compatible storage with quotas.

accountIdstring— Account ID
projectstring— Project name
regionstring— Storage region (e.g. us-east-1)
paymentProfilestring— Payment profile to use
usageCapGbnumber (optional)— Usage cap in GB

rotate_keys

Rotate access keys for a storage service.

serviceIdstring— Storage service ID
reasonstring (optional)— Reason for rotation

create_bucket

Create an S3-compatible storage bucket.

accountIdstring— Account ID
namestring— Bucket name (globally unique)
regionstring— Bucket region
isPublicboolean (optional)— Whether bucket is publicly readable

list_buckets

List all buckets for an account.

accountIdstring— Account ID

put_object

Get an upload URL for storing an object.

bucketNamestring— Bucket name
keystring— Object key (path)
sizenumber— Object size in bytes
contentTypestring (optional)— MIME type

put_object_complete

Finalize an object after uploading to the storage URL.

bucketIdstring— Bucket ID
keystring— Object key
storageIdstring— Storage ID from upload response
sizenumber— Object size in bytes
contentTypestring— MIME type
etagstring— ETag/hash of the content

get_object

Get an object download URL from a bucket.

bucketNamestring— Bucket name
keystring— Object key

delete_object

Delete an object from a bucket.

bucketNamestring— Bucket name
keystring— Object key

list_objects

List objects in a bucket with optional prefix filter.

bucketNamestring— Bucket name
prefixstring (optional)— Key prefix to filter by
maxKeysnumber (optional)— Max results (default 1000)

Example: tool discovery

Send a JSON-RPC 2.0 request to discover available tools.

POST /api/mcp
Authorization: Bearer eqf_your_key_here
Content-Type: application/json
Accept: application/json, text/event-stream

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list"
}

Example: call a tool

Create an account, attach payment, then provision storage.

POST /api/mcp
Authorization: Bearer eqf_your_key_here
Content-Type: application/json
Accept: application/json, text/event-stream

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "create_account",
    "arguments": {
      "orgName": "Forge Labs",
      "contact": "ops@forgelabs.ai"
    }
  }
}

S3-compatible endpoints

Direct HTTP access for S3 clients. Same API key auth via Authorization: Bearer eqf_...

PUT  /s3/{bucket}          Create bucket
PUT  /s3/{bucket}/{key}    Upload object
GET  /s3/{bucket}          List objects
GET  /s3/{bucket}/{key}    Download object
DELETE /s3/{bucket}/{key}  Delete object
DELETE /s3/{bucket}        Delete bucket
HEAD /s3/{bucket}/{key}    Object metadata