Rendering infrastructure for agents

Discover live service facts

Agents should read the public machine endpoints at runtime instead of hard-coding price, capacity, or request limits.

• GET /v1/capabilities
• GET /v1/pricing
• GET /v1/limits
• GET /v1/openapi.json

Model Context Protocol (MCP)

The FARPY MCP server lets autonomous agents discover and invoke FARPY's 10 MCP tools over a standard stdio connection. Set the FARPY_API_KEY environment variable in the agent's MCP server configuration; the key is read from the environment and is not part of a tool call.

Before rendering, agents can inspect the live capabilities, pricing, and limits contracts. FARPY MCP is currently available as a LIVE_PUBLIC_ALPHA interface, so agents should rely on those live contracts rather than hard-coded assumptions.

Agent-ready path

1. Sign in and create an API key in Account Settings.
2. Read capabilities, pricing and limits at runtime instead of hard-coding assumptions.
3. Use the dependency-free Python client or the OpenAPI 3.1 contract.
4. Submit with an idempotency key and an optional signed terminal webhook.
5. Poll status or consume render.completed, render.failed and render.cancelled events.
6. Download the output, receipt and proof after terminal completion.

One-call Python workflow

import os
from farpy_client import FarpyClient, FarpyError

client = FarpyClient(os.environ["FARPY_API_KEY"])

try:
    result = client.render(
        "scene.blend",
        output_path="render.zip",
    )
    print(result["job_id"])
    print(result["receipt"])
    print(result["proof"])
except FarpyError as exc:
    print(exc.code)
    print(exc.retryable)
    print(exc.suggested_action)
    print(exc.request_id)
    raise

Download farpy_client.py · Open the Python example · Error contract · Webhook contract

Production flow

capabilities
pricing
upload
submit
status
cancel before worker claim
download
receipt
proof

API properties

• API-key authentication
• Public price: $0.01 per completed Blender Cycles frame
• Frame ranges from 1 to 10,000 frames per request
• 100 MiB upload limit
• Idempotent submission support
• 60 requests per minute plus burst capacity
• Cancellation before worker claim
• Signed terminal webhooks
• Receipts and proof artifacts
• Machine-readable OpenAPI 3.1 specification

Start here

curl -sS https://farpy.com/v1/capabilities \
  -H "Authorization: Bearer $FARPY_API_KEY"

API overview · Quickstart · OpenAPI · Pricing · Status · Proof