This server has been archived and is no longer actively maintained.
Config is the same across clients — only the file and path differ.
{
"mcpServers": {
"spreshapp": {
"args": [
"-y",
"spreshapp-mcp"
],
"command": "npx"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
MCP server that connects Claude to SpreshApp's Facebook ad intelligence platform.
Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.
npx -y 'spreshapp-mcp' 2>&1 | head -1 && echo "✓ Server started successfully"
After testing, let us know if it worked:
Five weighted categories — click any category to see the underlying evidence.
No known CVEs.
Checked spreshapp-mcp against OSV.dev.
Be the first to review
Have you used this server?
Share your experience — it helps other developers decide.
Sign in to write a review.
Others in marketing
DataForSEO API modelcontextprotocol server
Salesforce CRM integration — opportunities, accounts, SOQL, file downloads, analytics
MCP server for Google News and Google Trends
MCP server for Mindbox CDP API — customer profiles, orders, segments. 3 tools.
MCP Security Weekly
Get CVE alerts and security updates for io.github.PrashantBtkl/spresh-mcp and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
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.
Add this to your claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"spreshapp": {
"command": "npx",
"args": ["-y", "spreshapp-mcp"]
}
}
}
Restart Claude Desktop after saving.
claude mcp add spreshapp -- npx -y spreshapp-mcp
{
"mcp": {
"servers": {
"spreshapp": {
"command": "npx",
"args": ["-y", "spreshapp-mcp"]
}
}
}
}
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 sk_sprs_.
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: SPRESHAPP_ACCESS_TOKEN, SPRESHAPP_REFRESH_TOKEN, SPRESHAPP_CLIENT_ID, and SPRESHAPP_TOKEN_EXPIRES_AT.
Check auth status:
npx -y spreshapp-mcp status
To log in again:
npx -y spreshapp-mcp logout
npx -y spreshapp-mcp login
| 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 |
| 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 |
| 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 |
Find 10 high-performing Facebook video ads in the fitness niche and summarize the a
... [View full README on GitHub](https://github.com/prashantbtkl/spresh-mcp#readme)