MCP n8n Quickstart

This guide provides a direct n8n implementation path for Revspire MCP.

Step 1: Create OAuth Connection in Revspire

1. Go to Revspire > Setup > OAuth.
2. Select template: n8n MCP Browser Flow (Production).
3. Set callback URL to your n8n callback URL.
4. Save and copy Client ID and Client Secret.

Step 2: Configure OAuth2 Credential in n8n

Use OAuth2 Authorization Code flow with PKCE.

Set MCP URL to https://mcp.revspire.io/mcp.

Values

Auth URL: https://login.api.revspire.io/oauth/authorize
Access Token URL: https://login.api.revspire.io/oauth/token
Scope: openid profile email offline_access revspire.mcp.tools.read revspire.mcp.tools.write
Client Authentication: client_secret_post

Step 3: Test MCP Reachability

First test unauthenticated health:

GET https://mcp.revspire.io/mcp/health

Then test authenticated initialize:

POST https://mcp.revspire.io/mcp
Body:
{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "initialize",
  "params": {}
}

Step 4: Call Tools from n8n HTTP Nodes

Example tool call body:

{
  "jsonrpc": "2.0",
  "id": "2",
  "method": "tools/call",
  "params": {
    "name": "dealroom.list",
    "arguments": {
      "search": "renewal",
      "page": 1,
      "page_size": 10
    }
  }
}

Best Practices

• Use separate OAuth connections for dev, staging, and production.
• Use least-privilege scope sets when workflows are read-only.
• For mutation tools, pass a stable idempotency_key for retries.
• Capture and log request_id for traceability.

Troubleshooting

• 401/403: token or scope mismatch, reauthorize credential.
• 429: reduce call burst and add backoff.
• 504: narrow query scope or split workflow steps.