Skip to main content
Everything you do over MCP draws on the same subscription as the Surfer app. The plan, the credits, and the usage view are the ones you already have.

​
Plans that include MCP

MCP is included in the Pro, Peace of Mind, Enterprise, and AI Search Analytics plans. Some older plans and trials include it as well; the MCP tab in the app shows whether yours does. Actions that create or generate content count toward your plan limits. Reading data does not. If your organization’s plan stops including MCP, every tool call fails with a permission error; Troubleshooting quotes it. What happens to the connection is on Authentication.

​
Tools that consume credits

Creating content and running optimization can consume credits. Reading data, replacing a document body, editing guidelines or settings, and deleting templates or voices do not. Some plans include AI Article generation in the Content Editor allowance. On those plans, starting an article does not spend a separate AI Article credit. On plans that use separate AI Article credits, Surfer reserves one when generation starts. Reading, editing, and approving that article’s outline do not cost another credit. If Surfer marks an article as failed, it releases the reserved AI Article credit. A retry reserves an available credit again; the released credit keeps its original expiry. Retrying an article that has not begun processing reuses its existing reservation.
A timeout does not mean the work failed or its credit was released. Check the job’s status before starting another run. Auto-Optimize can charge again for a second run on the same editor.
Creating a Content Editor supports a retry key. Ask your assistant to reuse the same key after an unclear result so Surfer returns the original editor instead of creating and charging for another. Deleting a Content Editor in the app does not refund its credit, and the deleted editor still counts toward fair usage. No MCP tool deletes one (changes and deletions). Skills, the built-in playbooks that run a whole Surfer workflow from one request, call these same tools. A playbook that creates a Content Editor or generates an article follows the same credit rules as those actions above.
  • The outline, brief, optimize, and recommendation playbooks can reuse an existing Content Editor, so a rerun need not spend another Content Editor credit.
  • The article playbook always creates a Content Editor, so each run spends a credit; a retry after a failure returns the original editor.

​
When credits run out

When you run out of one of these credits, the tool call fails with a quota error. Your assistant cannot create more of that kind until the quota resets or your plan changes. Troubleshooting quotes the error strings.
No tool reports remaining credits. Before a run of tool calls that charge, check Settings → Usage in the app.
Creating a workspace, content template, or custom voice also fails with a quota error when you reach your plan’s allowance. These are limits on how many you can have, rather than credits spent per action. Remove unused templates or voices, or check your plan allowance before creating more.

​
Rate limit

Requests are rate limited per organization and per tool, and everyone connected to the organization shares each limit. When a tool hits its limit, its calls fail with a rate-limit error that says how long to wait, and other tools keep working; your assistant should wait and retry. Troubleshooting quotes the error.

​
Timeouts and long-running tools

Some actions keep running after your client stops waiting for a response. Your assistant can check their progress. See the capabilities overview for the work Surfer can perform.
A call that returns early may already have started work and reserved or spent a credit. Ask your assistant to check the job’s state instead of starting it again.
Before retrying an unclear result:
  • Reading data: retrying does not spend a credit.
  • Creating a Content Editor: have your assistant reuse the same retry key to avoid creating and charging for a duplicate.
  • Generating an article: check its status first. Surfer refuses another generation while the article is in progress or already complete. For failed articles, the credit rules above explain how released credits are reused.
  • Running Auto-Optimize: check the editor for an existing job first. A second run can charge another credit and replace the work already in progress.

​
Input limits

Surfer enforces limits on text length, list sizes, and report ranges. Your assistant receives the current requirements from the connected tools. If a request exceeds a limit, have it adjust the input or split the work into smaller requests. Check the credit rules before splitting an action that charges.

​
Limits your client adds

Surfer sets no per-client limit. Your client may cap the number of tools it loads or the time it waits for a call. The caps below are the client’s own, documented on the linked vendor pages.