Select the operations worth exposing
Define one mapper per MCP tool so the model sees a small, intentional API surface instead of an entire OpenAPI catalog.
APICP · OpenAPI to MCP
APICP turns any OpenAPI spec into a focused MCP server — the right operations exposed, auth handled, responses cleaned. Your Frags Blueprints call it like any other tool. No bespoke MCP server to build or maintain.
openapi.yaml → apicp.yaml → MCP serverYour OpenAPI spec
One MCP tool
searchPlansSearch for blueprints by partial name match.
context: {} server: url: https://api.example.com/v2 mappers: - name: searchPlans description: Search for blueprints by partial name match. values: - path: header.Authorization value: "Bearer {{ .token }}" inputSchema: search: path: query.search description: Partial Blueprint name to search for. outputTransformer: "[*].{id: id, name: name}"Why it exists
Most OpenAPI specs are written for client libraries and human developers. APICP makes the same APIs legible to models by narrowing scope, stabilizing inputs, and cleaning responses before they enter context.
Define one mapper per MCP tool so the model sees a small, intentional API surface instead of an entire OpenAPI catalog.
Move auth, tenancy, defaults, and server overrides into config while keeping only the right fields in the LLM-facing schema.
Use JMESPath transformers to trim noisy API payloads into the exact fields a workflow needs for reliable downstream reasoning.
How it works
APICP is the on-ramp between the APIs you already have and the deterministic Blueprints you run on Frags. Bring a spec; leave with a tool your workflows can call.
Bring any REST API's spec. No SDK to wrap, no bespoke MCP server to write and keep in sync.
Pick the operations worth exposing, move auth and tenancy into config, and trim noisy responses with JMESPath — all declarative.
The generated MCP drops straight into your Blueprints. Frags calls it like any other tool — deterministic and schema-validated, on your infra or Barndoor Automations cloud.
Config surface
APICP keeps API mapping declarative. You decide which request fields are fixed, which ones the model supplies, and how response data is shaped before it's handed back to the workflow.
contextInbound headers and shared variablesvaluesHardcoded or templated request fieldsserver.urlA clean base URL when the spec is wrongmappersThe MCP tools APICP exposesinputSchemaLLM-facing inputs mapped to request pathsoutputTransformerJMESPath cleanup before the model sees dataAPICP narrows the API into clean tools. Frags runs the Blueprint that decides when they're called and what happens to the result.