Topic
Agents guess field names when they never see the contract. Serve the spec over MCP, generate one verified vertical slice at a time, run scenarios against localhost, and rescan to catch drift.
Read articleFunction calling is a model capability; plugins were a ChatGPT-era distribution experiment; MCP is a transport and discovery protocol between clients and tool servers. They are not competitors, and confusing them produces bad integrations. Here is the layered view and where your OpenAPI spec fits.
Read articleA concrete Cloud walkthrough: publish a managed Streamable HTTP MCP endpoint from one spec, expose twelve operations out of forty-seven, gate agents with a rotated bearer key, inject upstream auth, and pin the partner to an immutable version.
Read articlePasted docs rot mid-session, burn tokens on every conversation, and leave the agent guessing field names. An MCP server generated from the OpenAPI spec gives an agent callable tools with typed inputs instead of prose. Here is when that wins and when it does not.
Read articleHand-writing tool wrappers around existing order and inventory endpoints means maintaining every contract twice. Generate the MCP server from the OpenAPI spec, start with read-only tools, and widen the surface deliberately.
Read articleA real integration walkthrough: import the vendor OpenAPI file once, let the assistant and your coding agent read the exact contract, and send real requests locally, with no more curl archaeology in chat windows.
Read articleThe create call returned 200, the detail view 404s, and cancel accepts an illegal state. Scenario tests chain real calls, pass data between steps, and hand the agent evidence to fix with.
Read articleFake objects in components demo well and integrate badly. Agree on the coupon validation contract first, then let a spec-driven mock answer real HTTP while the service is still being built.
Read articleAI agents need tools, and hand-writing MCP wrappers around your API recreates the exact drift problem OpenAPI solved. Powerduck Cloud turns one spec into hosted docs and a ready-to-use MCP endpoint.
Read articleGenerated screens fail on limit versus pageSize, data.records versus data.items, cents versus dollars. The fix is not a better prompt; it is letting the agent query the real contract and verify against real responses.
Read articleEvery new coding assistant starts with the same ritual: paste the docs, explain the fields, warn about stale versions. A local spec served over MCP makes that context permanent.
Read articleA booking app built from one prompt can pass every visual check and still fail on time zones, double bookings, and stale cancel responses. Teams need a contract both people and tools can query, change, and verify.
Read article