The Powerduck Blog

API engineering, from the spec out

Product updates, engineering notes, and guides for designing, debugging, testing, mocking, and serving MCP tools from one OpenAPI spec.

Browse the guides
MCP & Coding 2 min read

Free MCP Hosting Limits: Smithery vs Powerduck Hub

Quick answer Short answer: Both platforms offer a free tier, but the limits are shaped differently. A registry's free tier is metered per call and limited in namespaces;

Read article
MCP & Coding 2 min read

MCP Server OAuth: Smithery vs Powerduck

Quick answer Short answer: A gateway's managed OAuth is the right tool for connecting agents to third-party services, because it centralizes client credentials and consent. A generated server

Read article
MCP & Coding 2 min read

Self-Hosted MCP vs a Smithery Gateway

Quick answer Short answer: A gateway handles credentials, OAuth, and sessions for you and sits in the call path; a self-hosted server runs on your own infrastructure with no intermediary.

Read article
MCP & Coding 2 min read

Local-First API Mocking for Cursor Agents

Quick answer Short answer: Give the agent a local mock generated from the spec, not a live backend. It is deterministic, contract-shaped, and returns the edge cases on demand, with

Read article
MCP & Coding 2 min read

Cursor and Powerduck: Why They Are Better Together

Quick answer Short answer: The two tools sit at different layers and compose cleanly. Cursor writes the code and drives the agent; Powerduck defines the contract, generates the typed tools

Read article
MCP & Coding 2 min read

API Testing in Cursor vs a Contract-Verified Workflow

Quick answer Short answer: An editor can write a test, but it cannot prove the response conforms to the API. A contract-verified workflow checks each response against the schema and

Read article
MCP & Coding 2 min read

Why Cursor Hallucinates API Calls Without a Spec

Quick answer Short answer: An agent hallucinates an API call because it is predicting the next token, not reading your server. Without a contract, it fills in the endpoint, parameters,

Read article
MCP & Coding 2 min read

Cursor MCP Config vs an OpenAPI-Generated MCP Server

Quick answer Short answer: A hand-written MCP entry in Cursor's config is plumbing you maintain; a generated server is derived from the contract. Both expose tools to the

Read article
MCP & Coding 2 min read

How to Give Cursor Accurate API Tools with an MCP Server

Quick answer Short answer: Generate an MCP server from your OpenAPI spec, run it locally, and add it to Cursor's MCP configuration. The agent then calls typed tools

Read article