📚 Tape MCP Server Documentation

🚀 Getting Started

Step 1: Get Your Coupon Code

Contact Syncrony to receive your beta access coupon code. This is a one-time setup step.

Step 2: Get Your Tape API Key

1. Log into Tape
2. Click your avatar in the top-right corner
3. Go to Preferences → API
4. Copy your API key (starts with user_key_)

Step 3: Generate Your JWT Token

1. Visit https://tapemcp.syncrony.ca/
2. Enter your coupon code
3. Enter your Tape API key
4. Click "Generate Access Token"
5. Copy the JWT token from the success page

⚡ Rate Limiting & Usage Control

The Tape MCP Server enforces rate limits to ensure fair usage and protect server resources:

Per-Minute Rate Limiting

Monthly Usage Limits

What Counts Against Your Limits

Checking Your Usage

Use the getRateLimitInfo tool to check your current usage:

The tool returns:

• Current per-minute usage and limit
• Monthly tool calls used and limit
• Time until per-minute window resets
• Date when monthly limit resets

Rate Limit Errors

If you hit a rate limit, you'll receive a structured error response:

Per-minute limit exceeded:

{
  "success": false,
  "status_code": 429,
  "error": "Rate limit exceeded",
  "details": {
    "requestsThisMinute": 60,
    "ratePerMinute": 60,
    "resetIn": "23 seconds"
  }
}

Monthly limit exceeded:

{
  "success": false,
  "status_code": 429,
  "error": "Monthly limit exceeded",
  "details": {
    "monthlyToolCalls": 10000,
    "monthlyLimit": 10000,
    "resetsOn": "2025-12-01T00:00:00Z"
  }
}

⚙️ Configuration

For Claude Code

Create or edit .mcp.json in your project:

{
  "mcpServers": {
    "tape": {
      "type": "http",
      "url": "https://tapemcp.syncrony.ca/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_JWT_TOKEN_HERE"
      }
    }
  }
}

For Claude Desktop

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "tape": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://tapemcp.syncrony.ca/mcp",
        "--header",
        "Authorization: Bearer YOUR_JWT_TOKEN_HERE"
      ]
    }
  }
}

🛠️ All Available Tools

The Tape MCP Server provides 55 tools organized into 7 categories for comprehensive Tape API access.

1. Connection & Information 4 tools

2. Workspace Management 8 tools

3. App Management 9 tools

Basic Operations

Field Management

4. Record Operations 14 tools

Basic CRUD

Advanced Operations

5. Record Comments 4 tools

6. Webhook Management 5 tools

7. Organization & Permissions 2 tools

🔧 Troubleshooting

"Authentication failed" or "Invalid JWT token"

• Check JWT token: Ensure you copied the entire token from the success page
• Token expired: JWT tokens expire after 7 days. Generate a new one
• Incorrect format: Token should start with eyJ and be very long
• Missing "Bearer" prefix: Verify configuration has "Authorization": "Bearer YOUR_JWT_TOKEN_HERE"
• Restart your MCP client after updating the JWT token

"Invalid coupon code"

• Contact Syncrony to receive a valid beta access coupon code
• Coupon codes are case-sensitive
• If you previously had access, your coupon code is still valid

"Forbidden" or "Access denied"

• JWT token may have expired - generate a new one
• Check permissions in your Tape account
• Verify your Tape API key is still valid

"Resource not found"

• Verify the app_id, workspace_id, or record_id exists
• Check you have permission to access that resource
• Resource may have been deleted

"Tool not found" or "MCP server not responding"

• Restart your AI assistant after updating configuration
• Verify URL is correct: https://tapemcp.syncrony.ca/mcp
• Check Authorization header is configured
• Verify JWT token hasn't expired (7-day limit)

"ReadableStream is not defined" or "Server disconnected" (Claude Desktop)

• Cause: Node.js version is too old (need 18+)
• Fix 1 (Recommended): Upgrade Node.js to version 18 or higher
• Fix 2 (macOS): If the simple config doesn't work, you may need to specify the full path to npx:
  • Find your npx location: Open Terminal and run which npx
  • Use the full path in your config: "command": "/usr/local/bin/npx" (or whatever path was returned)
• Fix 3 (Windows): If the simple config doesn't work:
  • Find your npx location: Open Command Prompt and run where npx
  • Use the full path in your config: "command": "C:\\Program Files\\nodejs\\npx.cmd" (or whatever path was returned)

💬 Need Help?

• Beta Access & Coupon Codes: Contact Syncrony
• JWT Token Generation: https://tapemcp.syncrony.ca/
• Tape Support: help.tapeapp.com
• Tape API Docs: developers.tapeapp.com
• MCP Protocol: modelcontextprotocol.io