Render archival, accessible PDFs from markdown or a template DSL without
leaving Cursor. This plugin connects the Cursor agent to the
makesPDF MCP server, adds a makespdf skill that
knows the authoring workflow, and ships a command for the common
markdown-to-PDF case.
Every PDF is tagged and dual-compliant: PDF/A-2A for archival and PDF/UA-1 for accessibility. Rendering is deterministic and takes about a second, with no headless browser to launch.
| Component | Path | What it does |
|---|---|---|
| MCP server | mcp.json |
Connects Cursor to https://makespdf.com/api/v1/mcp over OAuth. |
| Skill | skills/makespdf/SKILL.md |
Teaches validate → preview → render, and how to save the PDF. |
| Command | commands/render-markdown-to-pdf.md |
Renders the current markdown file and saves the PDF to the workspace. |
| Plugin manifest | .cursor-plugin/plugin.json |
Marketplace metadata. |
Once the plugin is listed: open Customize in Cursor, search for makesPDF, choose Install, and pick a project or user scope.
To try this repository before it is listed, copy it into Cursor's local plugin directory:
mkdir -p ~/.cursor/plugins/local
rm -rf ~/.cursor/plugins/local/makespdf
cp -R /path/to/makespdf-cursor-plugin ~/.cursor/plugins/local/makespdfThen restart Cursor or run Developer: Reload Window and confirm the
components appear under Customize. Cursor skips symlinks that resolve
outside ~/.cursor/plugins/local, so copy the folder rather than linking it.
The MCP server authenticates each user with their own makesPDF account through OAuth. On the first tool call Cursor shows an Authenticate prompt; approve it in the browser. The consent page names cursor.com and the localhost return address Cursor uses. There is no API key to paste and no plugin variable for a team admin to set.
If you don't have a makesPDF account yet, create one at https://makespdf.com first, then re-run the tool call and approve the prompt.
Ask the agent for what you want, for example:
Render this markdown file to an accessible PDF and save it next to the source.
or run the bundled command from chat:
/render-markdown-to-pdf
The agent picks the right makesPDF tools on its own, but the shape of the workflow is always the same:
- Markdown —
validate_markdown(free), thenrender_markdown. - A new or edited DSL template —
validate_dsl(free), thenrender_dsl_preview(free, watermarked), thensave_template, thenrender_template. - An existing template —
list_templates/get_template, thenvalidate_dsl(free) on the DSL it returns, thenrender_template.
Billed renders return a short-lived downloadUrl; the agent downloads the PDF
from it into your workspace. Links last 15 minutes, and
get_render_download_url re-issues one from the render's artifactId for
free.
validate_dsl, validate_markdown, render_dsl_preview, render_markdown,
render_template, save_template, list_templates, get_template,
update_template, delete_template, get_render_download_url,
report_feedback.
render_markdownandrender_templatecost 1 credit per 10 pages on success. A failed render deducts nothing, and both reportcreditsDeductedandcreditsRemainingin their metadata.validate_dsl,validate_markdown,render_dsl_preview, template management andget_render_download_urlare free.- Previews are always stamped
PREVIEW — NOT FOR USE. On the free plan, billed renders are watermarked; paid plans render clean.
OAuth is the recommended path for interactive use. If you need an API key
instead (CI, a shared machine, or a Cursor build without the auth field),
add a separate MCP entry with a Bearer header in ~/.cursor/mcp.json:
{
"mcpServers": {
"makespdf-api-key": {
"url": "https://makespdf.com/api/v1/mcp",
"headers": {
"Authorization": "Bearer mpdf_your_api_key"
}
}
}
}Create keys at https://makespdf.com/settings/api-keys. Keep the key out of version control.
Email support@makespdf.com, or call the free report_feedback tool from a
Cursor session (it reports tool and workflow problems to the makesPDF team).
- MCP documentation: https://makespdf.com/docs/mcp
- Template authoring skill: https://makespdf.com/skills/pdf-template-author.md
- Repository: https://github.com/makesPDF/makespdf-cursor-plugin
MIT — see LICENSE.