APIs

Build on the platform that builds your cloud.

Everything in the Pinpole UI is available as an API. Create architectures, run simulations, and trigger deployments programmatically — with type-safe SDKs for TypeScript and Python.

Read the docs Explore endpoints →

$ curl -X POST https://api.pinpole.cloud/v1/architectures \
  -H "Authorization: Bearer $PINPOLE_API_KEY" \
  -d '{
    "prompt": "Event-driven image pipeline on AWS",
    "simulate": { "rps": 1000 }
  }'

// 201 Created
{
  "id": "arch_8fk2m",
  "resources": 27,
  "simulation": { "p50_ms": 26, "monthly_cost": 182 }
}

import { Pinpole } from "@pinpole/sdk";

const pinpole = new Pinpole();

const arch = await pinpole.architectures.create({
  prompt: "Event-driven image pipeline on AWS",
});

const sim = await arch.simulate({ rps: 1_000 });

await arch.deploy({ env: "production" });

from pinpole import Pinpole

client = Pinpole()

arch = client.architectures.create(
    prompt="Event-driven image pipeline on AWS",
)

sim = arch.simulate(rps=1000)
print(sim.monthly_cost)  # 182

arch.deploy(env="production")

The API surface

Four resources. Full control.

Architectures

Generate, read and mutate infrastructure designs from prompts or diagrams.

POST /v1/architectures GET /v1/architectures/:id POST /v1/architectures/:id/explain

Simulations

Run traffic, cost and failure simulations against any architecture version.

POST /v1/architectures/:id/simulations GET /v1/simulations/:id/results GET /v1/simulations/:id/bottlenecks

Deployments

Plan, preview, deploy and roll back — the same engine behind the Deploy button.

POST /v1/deployments GET /v1/deployments/:id/status DELETE /v1/deployments/:id · rollback

Webhooks

Subscribe to deploy, simulation and drift events — push them anywhere.

POST /v1/webhooks GET /v1/events?type=deploy.completed

MCP Gateway

Your infrastructure,
available to every AI agent.

The Pinpole MCP server exposes your canvases, simulations and deployments as tools any MCP-compatible agent can call — Claude, Cursor, or your own.

pinpole_create_project pinpole_build_architecture pinpole_draw_on_canvas pinpole_simulate_cost pinpole_open_canvas

@pinpole/mcp on npm →

agent session

$ npm install -g @pinpole/mcp
✓ pinpole-mcp connected (9 tools)

› Design a RAG pipeline and estimate its cost

⏺ pinpole_build_architecture("RAG pipeline")
  └─ 14 resources on canvas
⏺ pinpole_simulate_cost(rps: 500)
  └─ $96/month · no bottlenecks

⏺ Done — canvas ready to review.

Ship your first architecture
in five API calls.

Get an API key Read the docs

Free tier · 1,000 requests/month · No credit card