Spresh MCP server

spreshapp-mcp

MCP server that connects Claude to SpreshApp's Facebook ad intelligence platform.

Ask Claude to research competitors, decode winning ad angles, track brand ad history, and analyze your saved ad library, all directly from your Claude Desktop or Claude Code session.

Requirements

• Node.js >= 20
• A SpreshApp account

Setup

Claude Desktop

Add this to your claudedesktopconfig.json (macOS: ~/Library/Application Support/Claude/claudedesktopconfig.json):

{
  "mcpServers": {
    "spreshapp": {
      "command": "npx",
      "args": ["-y", "spreshapp-mcp"]
    }
  }
}

Restart Claude Desktop after saving.

Claude Code

claude mcp add spreshapp -- npx -y spreshapp-mcp

VS Code (with MCP extension)

{
  "mcp": {
    "servers": {
      "spreshapp": {
        "command": "npx",
        "args": ["-y", "spreshapp-mcp"]
      }
    }
  }
}

Authentication

Authenticate once before starting the MCP server:

npx -y spreshapp-mcp login

This opens your browser to log in with your SpreshApp account (OAuth 2.0 with PKCE). After login, credentials are saved to ~/.spreshapp/credentials.json (file mode 600) and refreshed automatically before each session.

For headless or remote agent environments, use a SpreshApp API key from the dashboard instead of browser OAuth:

npx -y spreshapp-mcp login --no-browser

This prints setup instructions for the user and agent. The user can create or copy a key at spreshapp.com/app/api-access. Keys start with sksprs.

Set the key in the MCP server environment:

SPRESHAPP_API_KEY=sk_sprs_... npx -y spreshapp-mcp

OAuth token variables are still supported for advanced setups: SPRESHAPPACCESSTOKEN, SPRESHAPPREFRESHTOKEN, SPRESHAPPCLIENTID, and SPRESHAPPTOKENEXPIRES_AT.

Check auth status:

npx -y spreshapp-mcp status

To log in again:

npx -y spreshapp-mcp logout
npx -y spreshapp-mcp login

Available Tools

Ad tools

Brand tools

Library tools

Example prompts

Shortened. The full README is on GitHub.