MCP Setup

MCP (the Model Context Protocol) is how AI agents talk to tools. Connect the SpiderPublish MCP server to your agent and it gains a set of SpiderPublish tools — create pages, write posts, build forms, deploy — that it can call directly in a conversation.

Which package to use

There are two MCP servers, depending on how many tools your agent should see:

  • @spideriq/mcp-publish — the SpiderPublish toolset (pages, posts, docs, templates, components, forms, domains, media, deploy). Use this if SpiderPublish is what you are working on.

  • @spideriq/mcp — the full SpiderIQ toolset (everything above plus the other SpiderIQ products). Use this if you need the broader platform in one place.

Both are published to the SpiderIQ registry at npm.spideriq.ai.

Configure your agent

Add an entry to your agent's MCP configuration (commonly a .mcp.json file). For SpiderPublish:

{
  "mcpServers": {
    "spideriq-publish": {
      "command": "npx",
      "args": ["-y", "@spideriq/mcp-publish"],
      "env": {
        "SPIDERIQ_FORMAT": "yaml",
        "npm_config_registry": "https://npm.spideriq.ai"
      }
    }
  }
}

Restart your agent and the SpiderPublish tools appear.

Useful environment variables

  • SPIDERIQ_FORMAT — yaml, md, or json. yaml and md are more compact and save tokens; json is the default.

  • npm_config_registry — point npm at https://npm.spideriq.ai so it can fetch the package.

Authenticate

The first time your agent uses a tool, it needs a token. The simplest path is to request access from the CLI, which emails your admin for approval:

spideriq auth request --email you@yourcompany.com

Once approved, your credentials are stored and reused. See Authentication for the full flow and token format.

Bind to a workspace

If you work in a directory, bind it to your workspace so every call targets the right site:

spideriq use <your-workspace>

This writes a small spideriq.json file that the MCP server reads, so the agent always knows which workspace (and which project) it is operating on.

Try it

Ask your agent something concrete:

"List my pages. Then create a page called 'pricing' with a hero and a
three-tier pricing table, and show me a deploy preview."

The agent will call content_list_pages, content_create_page, and the deploy-preview tool, and hand you a preview link before anything goes live.

Next steps