MCP Integration

Uplifted + Claude
Integration Guide

Everything you can do when Uplifted is connected to Claude via MCP — from simple asset searches to full creative audits with strategic recommendations. No technical commands needed.

🔍

Find & Organize

Search assets, manage folders and boards across all your brands.

📊

Analyze Performance

Pull ROAS, CPA, spend, thumbstop rate and more in seconds.

🎯

Creative Strategy

Audit creatives, find patterns, and get specific test ideas.

Installation Guide

Connect Uplifted to Claude in four steps. Once connected, all capabilities in Part 2 are available through conversation.

Prerequisites

An Uplifted account with at least one brand set up

Claude Code installed on your machine

Your Uplifted API key — from Settings → API / Integrations in your dashboard

Setup

Open your Claude Code MCP settings

Run this in your terminal, or open the config file directly:

claude mcp

# Or open the config file directly:
~/.claude/settings.json   # Global (all projects)
.claude/settings.json      # Project-specific

Add the Uplifted MCP server

Add the following to your mcpServers block in the config file:

{
  "mcpServers": {
    "uplifted": {
      "type": "sse",
      "url": "https://mcp.uplifted.ai/sse",
      "headers": {
        "Authorization": "Bearer your-api-key-here"
      }
    }
  }
}

Restart Claude Code

Exit and restart Claude Code, or run:

/mcp
# You should see 'uplifted' listed as a connected MCP server.

Verify the connection

Start a new conversation and type:

"Show me my brands"

# If you see your brand list, you're connected!

Troubleshooting

"Server not found" or connection error

Double-check your API key — no extra spaces or line breaks
Make sure the config is valid JSON (watch for trailing commas)
Restart Claude Code after any config change

"Unauthorized" or "403" error

Your API key may have expired — generate a new one from the Uplifted dashboard
Make sure your Uplifted account has API access enabled

Tools not showing up

Run /mcp in Claude Code to check server status
You should see: uplifted: connected (X tools available)
If it shows disconnected or error, check config syntax and API key

"Brand not found" errors

Run "Show me my brands" first to see which brands you have access to
Make sure you're referencing the exact brand name as it appears in Uplifted

Optional: Project-Level Context

Create a file at .claude/CLAUDE.md in your project so Claude remembers your brand context without you repeating it every time:

# Project Context
- Primary brand: [Your Brand Name] (ID: [brand-id])
- Focus: 'DTC skincare, anti-aging products'
- Key metrics we care about: ROAS, CPA, thumbstop rate
- Current campaign: 'Summer 2026 launch'

🔒 Your API key is stored locally in Claude Code config — it never leaves your machine. Claude accesses Uplifted data on-demand through the MCP connection.

What You Can Do

Talk to Claude in plain English — it pulls data from your Uplifted workspace, analyzes creatives, checks performance, and gives you strategic recommendations.

Connected Capabilities

Uplifted Concept	What Claude Can Do
Brands	See all your brands, switch between them
Asset Libraries	Search across BRAND, UGC, AD, and AD_ANALYTICS libraries
Assets	Find, view, read transcriptions, move, copy, delete, comment
Folders	Create and organize folder structures
Boards	Create, list, update, delete; add/move assets between boards
Tags	Filter assets by tags, look up tag IDs
Creative Clips	Filter by clip type (Pain Point, CTA, Solution, etc.)
Ad Analytics	ROAS, spend, CPA, CPM, thumbstop rate, CTR, and more

Tier 1

Just Ask

Simple, one-step requests. Claude pulls the data and gives you an answer.

Finding things

Show me my brands

Search for video assets tagged 'summer campaign'

Find all UGC assets uploaded this month

List my boards for [brand name]

Show me all assets in the 'Hero Ads' folder

Find 9:16 video assets in my brand library

Organizing things

Create a folder called 'Q2 2026 Creatives' in my brand library

Move this asset to the 'Winners' folder

Create a board called 'Summer Launch' and add these assets to it

Add a comment on this asset: 'Approved for launch'

Checking performance

Show me my top 10 ads by spend this month

What's my best ROAS ad in the last 30 days?

Which ads have a thumbstop rate above 30%?

Show me ads with CPA under $20 from last month

Tier 2

Claude Figures It Out

Claude chains multiple tools together automatically. Just say what you want.

Show me my top 5 ads by ROAS this month and pull the details on each creative

Claude will

Pull analytics

Identify top 5

Get asset details for each

Show creative info + performance side by side

Compare my 5 best and 5 worst performing ads this month — what's different about them?

Claude will

Pull analytics → get top 5 and bottom 5

Get transcriptions for each

Analyze patterns across winners and losers

Tell you what's structurally different

Create a board called 'March Winners' and add all ads with ROAS above 3x from this month

Claude will

Pull analytics with ROAS filter

Create the board

Add all qualifying assets automatically

How are my 'testimonial' tagged ads performing vs my 'product demo' tagged ads?

Claude will

Resolve tag IDs for both

Pull analytics filtered by each tag

Compare metrics side by side with commentary

Tier 3

Claude as Creative Strategist

Claude combines Uplifted data with vision, language analysis, and pattern recognition to give you strategic intelligence. No special command needed — just ask naturally.

🔎 Creative Audit

"Audit my creatives from the last 30 days. What's working, what's not, and what should I test next?"

Pull all ad analytics for the period

Segment into performance tiers (winners / middle / losers)

Analyze patterns across winners: hook types, messaging angles, CTA approach

Identify gaps — what's NOT being tested

Recommend 3–5 specific creative tests with rationale

🎬 Hook Analysis

"Analyze the first 3 seconds of my top performing video ads. What hook patterns are winning?"

Pull top performers by thumbstop rate

Get transcriptions and asset details

Categorize hook types: question, bold claim, social proof, pattern interrupt, etc.

Map hook type → performance metrics

Recommend hook frameworks to test next with specific examples

🌐 Creative Diversity Audit

"How diverse is my current creative mix? Am I over-indexing on any one format, angle, or style?"

Pull all active ads

Build a diversity matrix: format mix, message angles, hook diversity, CTA diversity

Identify concentration risks (e.g. "80% of spend is on one creative style")

Recommend specific gaps to fill, with priority ranking

✍️ Script & Copy Analysis

"Read the transcriptions of my top 10 ads and tell me what copy patterns are driving performance"

Pull top 10 by chosen metric

Analyze sentence structure, emotional triggers, specificity of claims, CTA language

Compare against bottom performers

Produce a copywriting brief for your next round of scripts

⚖️ Legal & Compliance Review

"Check my active ads for potential compliance issues"

Scan for unsubstantiated claims, missing disclaimers, fake urgency

Check FTC/platform policy flags: testimonials, health claims, results disclosure

Rate each ad: Clean / Review / Risk

Provide specific language fixes for flagged items

🔀 Winner Remix Strategy

"Take my top 3 winning ads and suggest 5 remix variations for each that I should test"

Analyze what makes each winner work: hook, structure, CTA, angle

Suggest: same hook/different body; same body/different hook; format variants; mashups

Prioritize variations by expected impact

📈 Quarterly Creative Report

"Give me a full quarterly creative report — performance trends, winner analysis, creative fatigue signals, and a plan for next quarter"

Identify trends: improving, declining, plateau

Flag creative fatigue: previously strong ads now declining

Produce: what to scale, what to kill, what to test next quarter, budget allocation suggestions

Reference

Metrics, time periods, and filters you can use in any request.

Available Metrics

SpendTotal ad spend

ROASReturn on ad spend

CPACost per acquisition

CPMCost per thousand impressions

CPCCost per click

ConversionsTotal conversions

ImpressionsTotal impressions

ViewsVideo views

Thumbstop Rate% who stopped scrolling (first 3 sec)

Avg Watch TimeAverage % of video watched

CTR (Outbound)Outbound click-through rate

Conversion RateConversion % from clicks

Time Periods

today last 7 days last 14 days last 30 days beginning of the month last month all time

Filters You Can Combine

By platform: Facebook, Google Ads By media type: VIDEO, IMAGE By tags: any tags from Uplifted spend > $100 ROAS > 2 thumbstop > 25%

Pro Tips

Be specific about what 'good' means

Add metric thresholds and time windows to get precise results.

"Show me ads with ROAS above 2.5x and spend over $500 in the last 14 days"

Name your brand if you have multiple

Avoid ambiguity when switching between brand accounts.

"For Lemonade, show me top performers this month"

Ask for the format you want

Claude adapts its output to however you need to use it.

"Give me this as a table" / "Rank these from best to worst"

Chain requests naturally

You don't need to break complex tasks into separate asks.

"Find my worst performing ads, figure out why they're failing, and suggest replacements based on what IS working"

Ask Claude to explain its reasoning

Get the logic behind every recommendation, not just the answer.

"Why do you think the testimonial ads are outperforming the product demos?"

Get started in 5 prompts

Run these in sequence on your first session.

1. "Show me my brands"
2. "Top 5 ads by ROAS, last 30 days"
3. "What patterns do winners share?"
4. "What am I not testing?"
5. "Create a brief for my next test"

When a Skill Helps vs. When to Just Ask

If you want something done consistently the same way every time with nothing skipped, a skill helps. If you're exploring, just ask naturally.

Request Type	Needs a Skill?	Why
Show me my top ads	No	Simple data pull
Compare winners vs losers	No	Claude chains tools and reasons through it
Full creative audit with scoring	Optional	Ensures consistent methodology
Compliance review	Recommended	Complex checklist — nothing gets missed
Weekly summary (recurring)	Use a skill	Scheduled + consistent format every time
What should I test next?	No	Claude's reasoning handles this well
Quarterly report	Recommended	Same structure, same depth, every quarter

Ready to connect?

Get your API key from Settings → API / Integrations in your Uplifted dashboard.

Read the docs Get API key →

Uplifted + ClaudeIntegration Guide

Find & Organize

Analyze Performance

Creative Strategy

Prerequisites

Setup

Open your Claude Code MCP settings

Add the Uplifted MCP server

Restart Claude Code

Verify the connection

Troubleshooting

Optional: Project-Level Context

Connected Capabilities

Available Metrics

Time Periods

Filters You Can Combine

Pro Tips

Be specific about what 'good' means

Name your brand if you have multiple

Ask for the format you want

Chain requests naturally

Ask Claude to explain its reasoning

5 prompts to get started

When a Skill Helps vs. When to Just Ask

Ready to connect?

Uplifted + ClaudeIntegration Guide

Find & Organize

Analyze Performance

Creative Strategy

Prerequisites

Setup

Open your Claude Code MCP settings

Add the Uplifted MCP server

Restart Claude Code

Verify the connection

Troubleshooting

Optional: Project-Level Context

Connected Capabilities

Finding things

Organizing things

Checking performance

Available Metrics

Time Periods

Filters You Can Combine

Pro Tips

Be specific about what 'good' means

Name your brand if you have multiple

Ask for the format you want

Chain requests naturally

Ask Claude to explain its reasoning

Get started in 5 prompts

When a Skill Helps vs. When to Just Ask

Ready to connect?

Uplifted + Claude
Integration Guide

Uplifted + Claude
Integration Guide