Cursor + MagicSlides MCPMake a document with Cursor
Cursor's agent can read the route handlers and schemas in your open repo, so it can document an endpoint exactly as it is built. With the MagicSlides MCP server, it publishes the reference page as a hosted doc for partners or other teams.
Set up MagicSlides in Cursor (one time)
Use the one-click link, or paste this into your Cursor MCP config.
{
"mcpServers": {
"magicslides": {
"url": "https://www.magicslides.app/api/mcp/mcp"
}
}
}- 1.Click the install link, or open Settings → Tools & MCP → Add Custom MCP and paste the JSON.
- 2.Click Connect next to magicslides and log in with MagicSlides.
- 3.Ask the agent for a deck in chat. It calls MagicSlides and returns the links.
Example: what you type in Cursor
Using @src/routes/invoices.ts and @src/schemas/invoice.ts, write an API reference page for the invoices endpoints with the object fields, each route, query params, error codes and idempotency. Publish it as a MagicSlides doc.
- Read the @-mentioned route file and Zod schema
- Listed 5 routes and the 8 fields of the invoice object
- Wrote request and response examples and an error code table
- Called create_doc and returned the share link
The Invoices API reference is published as a MagicSlides doc. It covers create, retrieve, list, finalize and void, the error codes from the handlers, and the Idempotency-Key header.
This is the real output from that prompt, made with the MagicSlides MCP. Open it to click through or download it.
How it works
- 1.Add magicslides to ~/.cursor/mcp.json with the url https://www.magicslides.app/api/mcp/mcp, or use the one-click install link
- 2.Log in with MagicSlides when Cursor connects
- 3.In Agent mode, @-mention the route and schema files and ask for an API reference doc
- 4.Share the returned link with whoever integrates the API
Tool used: create_doc. Prefer a web app? AI document generator does the same without an agent.
FAQ
How does Cursor know what the API does?
In Agent mode it reads your open repo, and you can @-mention the exact route and schema files to document.
What is the mcp.json entry?
{"mcpServers":{"magicslides":{"url":"https://www.magicslides.app/api/mcp/mcp"}}} in ~/.cursor/mcp.json.
Can external partners read the doc?
Yes. The share link is public, so partners can read it without a MagicSlides account.
Can I keep the doc in sync after changes?
Yes. Ask Cursor to read the updated files and revise the doc. MagicSlides has get_doc and update_doc for edits.
More with Cursor
Docs in other agents
Connect MagicSlides to Cursor
One MCP server for decks, docs, sheets and reels. Log in with your MagicSlides account, no API key. Making a deck from your own copy uses no AI credits.
