Spresh Mcp

io.github.PrashantBtklPublished by GitHub account PrashantBtklv1.0.3Updated Oct 27, 2026

Search Facebook ads, decode competitor creative strategy, and track brand ad history.

VerifiedSTDIODesktop onlyData & Analytics Business & Commerce

Server details

Identifier: io.github.PrashantBtkl/spresh-mcp
Transport: STDIO
Runtime: Desktop only
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account PrashantBtkl for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.PrashantBtkl%2Fspresh-mcp.svg)](https://sourceweft.com/mcp/io.github.PrashantBtkl%2Fspresh-mcp?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Connects Claude to SpreshApp's Facebook ad intelligence platform to search ads, analyze competitor creative strategy, and track brand ad history.

What you can do: Search Facebook ads by keyword, niche or industry, expand queries, and fetch full ad details
Run AI analysis on single or multiple ads and chat about an ad's creative strategy
Look up brands, view profiles and stats, tracking status, ad history and currently running ads, and start following a brand
Browse your saved ad library by folder, tag or saved page
When to use it: Useful for marketers, media buyers and founders who want to research competitors' Facebook ad creative and brand ad activity from inside a Claude session, or to query their own saved SpreshApp ad library.
Requirements: Runs locally via npx with Node.js 20 or newer. Requires a SpreshApp account and a paid plan for some tools. Authenticate once with the login command (browser OAuth 2.0 with PKCE) or, for headless setups, an API key in the SPRESHAPP_API_KEY environment variable; OAuth token variables are also supported.

Before you install

Credentials are stored in a local credentials file and an API key or OAuth tokens are read from the environment; treat them as secrets. Some tools are gated by subscription plan and daily quotas, and following a brand changes tracking state in your account. Ad research queries and library data are sent to SpreshApp's service.

Installation

In SourceWeft

Open Spresh Mcp in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

[SpreshApp logo]

spreshapp-mcp

MCP server that connects Claude to SpreshApp's Facebook ad intelligence platform.
[npm version] [Node 20+] [MCP compatible]

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.

[SpreshApp MCP in Claude Code]

Requirements

Node.js >= 20
A SpreshApp account

Setup

Claude Desktop

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

json

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

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

Restart Claude Desktop after saving.

Claude Code

VS Code (with MCP extension)

json

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

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

Authentication

Authenticate once before starting the MCP server:

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:

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 sk_sprs_.

Set the key in the MCP server environment:

OAuth token variables are still supported for advanced setups: SPRESHAPP_ACCESS_TOKEN, SPRESHAPP_REFRESH_TOKEN, SPRESHAPP_CLIENT_ID, and SPRESHAPP_TOKEN_EXPIRES_AT.

Check auth status:

To log in again:

Available Tools

Ad tools

Tool	Description
`ad_search`	Search Facebook ads by keyword, niche, or industry
`ad_search_expand_query`	Expand a search query to surface more relevant ads
`ad_get`	Fetch full details for a specific ad
`ad_get_analysis`	Retrieve saved AI analysis for an ad
`ad_analyze`	Run AI analysis on any ad
`ad_analyze_batch`	Analyze multiple ads in one call
`ad_chat`	Chat with Claude about an ad's creative strategy

Brand tools

Tool	Description
`brand_search`	Search for brands in SpreshApp
`brand_get_overview`	Get a brand's full profile and stats
`brand_get_status`	Get the current tracking status for a brand
`brand_get_ad_history`	Get historical ad volume data for a brand
`brand_list_active_ads`	List all ads a brand is currently running
`brand_follow`	Start tracking a brand

Library tools

Tool	Description
`search_ads`	Search your saved ad library
`get_folder_ads`	Get ads from a specific folder
`list_folders`	List all your saved folders
`get_tags`	List tags used across your library
`get_pages`	List saved Facebook pages

Example prompts

Research Nike's current Facebook ad strategy, how many ads are they running and what are the themes?

Research Nike's current Facebook ad strategy, how many ads are they running and what are the themes?

Troubleshooting

Symptom	Fix
Browser did not open	Copy the URL printed to the terminal and open it manually
"Authentication expired" error	Delete `~/.spreshapp/credentials.json` and re-run
"Not subscribed to any plan"	Visit spreshapp.com/pricing
"Daily limit reached"	Quota resets at midnight UTC, or upgrade your plan
"Feature not available"	Your current plan does not include this tool, upgrade at spreshapp.com/pricing

License

UNLICENSED — proprietary software. See spreshapp.com for terms.

Source: README.md at commit bb186a9

Tools

SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

v1.0.3LatestSep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts
Declare a license in the repository or the registry entry.