// mcp/cursor/

How do I add ToolForte to Cursor?

Click the install button on this page, or add the server to your mcp.json. Cursor connects over streamable HTTP and lists the tools in the MCP settings panel.

One click

Add to Cursor

Opens Cursor and asks you to confirm the server before it is added.

Step by step

The server URL is https://toolforte.com/api/mcp. Nothing runs on your machine; the client connects to it over streamable HTTP.

  1. 01
    Install with one click
    Click Add to Cursor. Cursor opens, shows the server it is about to add, and asks you to confirm.
  2. 02
    Or edit mcp.json
    Open Cursor Settings, choose MCP, click Add new global MCP server, and paste the configuration below. For one project, put the same JSON in .cursor/mcp.json in the project root.
  3. 03
    Enable the tools
    In the MCP settings panel the server shows a green dot and its tools. Agent mode uses them when a task calls for one.
  4. 04
    Try a tool
    In the chat, ask: "Validate the IBAN NL91 ABNA 0417 1643 00 with ToolForte."

Configuration

Cursor reads its MCP servers from ~/.cursor/mcp.json or <project>/.cursor/mcp.json.

mcp.json
{
  "mcpServers": {
    "toolforte": {
      "url": "https://toolforte.com/api/mcp"
    }
  }
}
mcp.json with an API key
{
  "mcpServers": {
    "toolforte": {
      "url": "https://toolforte.com/api/mcp",
      "headers": {
        "Authorization": "Bearer tf_your_key_here"
      }
    }
  }
}

Adding an API key

Does a key work in Cursor?
Yes: a headers object in mcp.json. Everything below applies.

Add a headers object next to the url, as in the second snippet. Cursor sends the header on every request.

A key starts with tf_ and is created on your account page. It is free, and it is what gives memory a private owner and workflows an account to run on.

Free or paid: what changes

Everything on this page works without paying. A key, free or paid, changes how much of the server-side work you can do in a month. A tool call costs 1 credit, a render 25, memory 0.

Without a keyFree keyToolForte Pro
PriceNothingNothing€19.00 a month, or €190.00 a year
Utility toolsAll of them, 200 requests a day per session1,000 credits a month, so up to 1,000 calls7,500 credits a month, so up to 7,500 calls
Renders (PDF, screenshot, read_page)3 a dayUp to 40 a month from the same balanceUp to 300 a month from the same balance
Agent memoryRefused: needs a key, so entries have an ownerPrivate to your key, kept 30 days, never meteredPrivate to your key, kept 365 days, never metered
Saved workflows (workflow_run)Refused: a workflow belongs to an accountYes, each step costs what its tool costsYes, each step costs what its tool costs
Usage historyNone7 days365 days
When the month runs outWait for tomorrowBuy credits from 100 for €1.00, they never expire, or move to ToolForte ProBuy credits from 100 for €1.00, they never expire

The same balance also pays for the REST API and the AI tools, and every tool result tells the assistant what is left. When it is gone the call is refused with a plain message; nothing keeps running on credit. Full detail on pricing and credits and plans.

From free to paid, in order

  1. Create a free account. An email address is all it asks for.
  2. On your account page, create an API key. It is shown once; copy it then.
  3. Put the key in Cursor as described above, and restart or refresh the connection.
  4. Ask for something server-side, such as a PDF. The result names your remaining balance, which proves the key arrived.
  5. Running low? Buy credits on the pricing page, or take ToolForte Pro there for the larger monthly balance. Both use the same key; nothing changes in Cursor.

Check that it works

One question is enough to see the server answer instead of the model.

Ask the assistant
Validate the IBAN NL91 ABNA 0417 1643 00 with ToolForte.
What a correct answer looks like
The assistant calls validate_iban and reports the result of the mod-97 check and the bank country. If it answers without calling a tool, the server is not connected yet: look for it in the client's MCP or connector list and make sure it is switched on for the conversation.

Questions

The Cursor specifics first, then what applies to every client.

The install button does nothing. What now?

The link uses the cursor:// scheme, which only works when Cursor is installed on the machine you are browsing from. Paste the mcp.json configuration instead; the result is the same.

Does Cursor ask before every tool call?

By default yes: agent mode shows the call and waits for approval. You can allow a server automatically in the MCP settings if you prefer.

What does the ToolForte MCP server cost?

The 84 deterministic utilities are free and so is agent memory. Each client session gets 3 renders a day without a key. With a free API key you get a monthly balance of 1,000 credits: a tool call costs 1 credit and a render 25, so that is 40 renders or 1,000 calls. ToolForte Pro is €19.00 a month for 7,500 credits, and any account can buy extra credits from 100 for €1.00 that never expire.

Do I need an API key?

Not for the utilities. A key is what makes memory private to you, gives access to the workflows on your account, and moves renders onto a monthly balance instead of the daily allowance. You create one on your ToolForte account page and pass it as an Authorization: Bearer header; an X-API-Key header works too.

Which tools does the server expose?

111 tools in four groups: 84 deterministic utilities such as validate_iban, calculate_vat, working_days_between, parse_cron and test_regex; 14 render tools (html_to_pdf, url_to_pdf, url_screenshot, qr_code_png, pdf_merge, pdf_split, images_to_pdf, image_resize, image_convert, image_compress, read_page, strip_metadata, pdf_to_docx, docx_to_pdf) that return hosted files or page content; 4 memory tools (memory_set, memory_get, memory_list, memory_delete); and 3 workflow tools (workflow_list, workflow_run, workflow_propose).

Is what I send to a tool stored?

Tool inputs are processed on ToolForte servers and not kept, except for the memory tools, whose entire purpose is to keep what you store, and rendered files, which are hosted for 24 hours behind a signed link. The browser tools on toolforte.com never send anything; the MCP server necessarily does.

Is there anything to install?

No. The server runs at toolforte.com and every client on this page connects to it over streamable HTTP. A client that only speaks stdio, such as the Claude desktop app on the free plan, runs "npx -y toolforte-mcp" instead: a small bridge on npm that connects to the same server.

What you can ask once it is connected

The server answers to 111 tool names. The full list, grouped and explained, is on the MCP page.

Check an IBAN or a VAT number, compute VAT on an amount, count working days between two dates in the Netherlands, explain a cron expression, test a regex, format or diff JSON, turn an HTML report into a hosted PDF, screenshot a page, read a JavaScript-rendered page as Markdown, remember something for next week, or run a saved workflow by id. See every tool.

Other clients
The MCP server
Every tool the server exposes, what each one costs, and the endpoint itself.
Claude
How do I add ToolForte to Claude?
Claude Code
How do I add ToolForte to Claude Code?
VS Code
How do I add ToolForte to VS Code and GitHub Copilot?
ChatGPT
How do I add ToolForte to ChatGPT?
Windsurf
How do I add ToolForte to Windsurf?
Gemini CLI
How do I add ToolForte to Gemini CLI?