Search Facebook ads, decode competitor creative strategy, and track brand ad history.
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.
Not yet automatically verified
We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.
Manual Client & Custom JSON ConfigExpand JSON ▾
Client Config & Setup
Choose your client or environment
Target File:
💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.
Capabilities & Tool Schemas (18)
Inspect callable tools, capabilities, and parameters exposed to AI agents by Spresh MCP.
ad_searchSearch Facebook ads by keyword, niche, or industry
ad_search_expand_queryExpand a search query to surface more relevant ads
ad_getFetch full details for a specific ad
ad_get_analysisRetrieve saved AI analysis for an ad
ad_analyzeRun AI analysis on any ad
ad_analyze_batchAnalyze multiple ads in one call
Documentation Overview
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 claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json):
Restart Claude Desktop after saving.
Claude Code
VS Code (with MCP extension)
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
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.
Related MCP Servers
Adoption & maintenance
Factual signals from GitHub, npm, and our automated checks — not a rating.
GitHub stars
1
Stargazers on the source repository.
Last commit
3mo ago
Most recent push to the default branch.
Tools exposed
18
Callable tools this server registers over MCP.
Reviews
No reviews yet — be the first to share how this listing worked for you.
Frequently Asked Questions about Spresh MCP
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
Badge Style:
Live Dynamic SVG Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/spresh-mcp)HTML Embed
<a href="https://allmcps.com/mcp/spresh-mcp"><img src="https://allmcps.com/api/badge/spresh-mcp?style=directory" alt="Spresh MCP on AllMCPs" /></a>Technical Specs & Signals
CategorySocial Media
11/13 checks healthy over the last 45d
48Quality signal: Fair · 48/100How this signal is calculated ▾
Server availabilityNot measured
Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.
Verified ownership10/20
Documentation & tools25/30
Adoption & activity1/15
Community engagement0/10
A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.
Supply-chain signal
No high-severity advisories surfaced by our automated scan.
Critical 0High 0Medium 0Low 0
Scanned 1d ago via OSV.dev · spreshapp-mcp (npm)
Own this project?
This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.
Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.
Claim & get free dofollowShare & Embed
Add our SVG badge (dark/light directory styles) or embeddable widget to your site.