Use Claude as a natural-language interface to WisePilot. Once connected via MCP (Model Context Protocol), you can generate images, browse your content library, analyze ad performance, pull metrics, and more — all from a Claude conversation.
Prerequisites
Before connecting, make sure:
- You have a WisePilot account — You need to be a member of at least one website
- Your role is Editor or higher — Generation tools require Editor access. Ask your workspace admin to add you if needed.
- You’re using Claude Pro, Team, or Enterprise — MCP connections require a paid Claude plan
Connecting Claude to WisePilot
Claude.ai (Web)
- Open claude.ai and sign in
- Click your profile icon in the bottom-left corner, then Settings
- Go to Integrations (or MCP Servers depending on your plan)
- Click Add Integration
- Enter the server URL:
https://ai.wisepilot.app/api/v1/mcp
- Claude will redirect you to WisePilot to log in
- On the consent screen, review the permissions and click Allow
- You’re connected — Claude will confirm the integration is active
Claude Desktop
- Open Claude Desktop and go to Settings (gear icon)
- Navigate to Integrations or MCP Servers
- Click Add and enter:
- Name: WisePilot
- URL:
https://ai.wisepilot.app/api/v1/mcp
- Save and restart Claude Desktop if prompted
- On first use, Claude will open a browser window for you to log in to WisePilot
- Review the permissions on the consent screen and click Allow
- Return to Claude Desktop — the connection is now active
Claude Code (CLI)
Add the server to your Claude Code configuration:
claude mcp add wisepilot --transport http https://ai.wisepilot.app/api/v1/mcp
What’s Available
Once connected, Claude can use these tools on your behalf. All tools are read-only unless noted otherwise.
Scoping & Navigation
Start here — these tools help Claude discover your websites and understand what’s available.
| Tool | What It Does |
|---|
| list_websites | See all websites you have access to |
| get_website_summary | Get details about a specific website (name, domain, integrations, content stats) |
Content Browsing & Search
| Tool | What It Does |
|---|
| list_assets | Browse content assets with filtering by type, status, or title |
| get_asset_detail | Get full detail on a specific asset including sections and SEO context |
| list_opportunities | See content opportunities ranked by priority |
| list_entities | Browse topics, concepts, and other content entities |
| get_entity_detail | Get entity details with priority scores and recent mentions |
| search_content | Full-text search across all your content |
| list_blogs | Browse blog posts with SEO metadata and section counts |
| list_ctas | Browse calls-to-action with click and conversion rates |
| list_nurture_sequences | View nurture sequences with step counts |
| get_sequence_steps | Get detailed steps within a nurture sequence |
Ad Campaigns & Creatives
| Tool | What It Does |
|---|
| get_ad_campaigns | Get campaigns with 30-day metrics (spend, ROAS, CTR, CPC, CPM, reach, frequency) plus objective, budget, and channel type |
| list_ad_creatives | Browse creatives with performance metrics, creative spec (headlines/descriptions/body copy), and ad set linkage |
| list_ad_sets | Browse ad sets with targeting/audience data (geo, age, gender, interests), 30-day metrics, and campaign linkage |
| get_ad_performance_daily | Daily creative performance breakdowns with date range filtering — reach, frequency, CPM, ROAS per day |
| get_campaign_performance_daily | Daily Google Ads campaign performance with date range filtering |
Google Ads Keywords & Search Terms
| Tool | What It Does |
|---|
| list_google_ad_keywords | Browse keyword performance with quality scores and date range filtering |
| list_google_search_terms | Browse search term reports with date range filtering |
| get_keyword_summary | Aggregated keyword totals (impressions, clicks, cost, conversions, CTR, CPC) — handles any data volume |
| get_keyword_grouped | Keywords deduplicated across daily snapshots — one row per keyword with aggregated metrics |
| get_search_term_summary | Aggregated search term totals — handles any data volume |
| get_search_term_grouped | Search terms grouped with server-side sorting and pagination — handles large datasets |
The get_keyword_summary and get_search_term_summary tools use SQL aggregation and work regardless of how many keywords or search terms exist. Use these for high-level analysis, and the _grouped variants for drill-down.
Generation
These tools create content and require Editor role or higher.
| Tool | What It Does |
|---|
| generate_image | Generate images using your brand styles and subjects |
| generate_content | Create blog posts, landing pages, emails, social posts via the governed AI pipeline |
| generate_ad_copy | Generate Google or Meta ad copy using your brand context |
Metrics & Dashboards
| Tool | What It Does |
|---|
| get_conversation_metrics | GHL conversation performance: volume, AI vs human handling, handoff rates |
| get_appointment_metrics | Appointment booking data: booked, showed, no-show counts and rates |
| get_revenue_metrics | Revenue and pipeline data: opportunities created, won, and revenue value |
| get_ad_campaign_overview | Ad campaign 30-day rollup metrics |
| get_ad_creative_performance | Daily ad creative performance trends |
| get_content_performance | Content performance: GSC metrics, GA4 pageviews, engagement data |
| get_tracking_summary | Tracking events: CTA clicks, form submits, calendar bookings, phone clicks |
| get_seo_overview | SEO overview: keyword clusters, search volume, difficulty, intent |
| get_keyword_rankings | Keyword rankings with GSC data and opportunity scores |
| get_gsc_pages | GSC page performance: clicks, impressions, CTR, position by date range |
| get_gsc_queries | GSC search queries by page with date range filtering |
| get_ga4_pages | GA4 page metrics: pageviews, users, sessions, bounce rate, conversions |
| get_ga4_events | Tracking events: CTA clicks, form submits, calendar bookings by date range |
| get_gbp_performance_daily | GBP daily metrics: calls, clicks, impressions, directions |
| get_gbp_reviews_list | GBP reviews with star ratings, comments, reply status |
| get_gbp_search_queries_list | GBP listing search queries with impressions |
| get_cta_performance | CTA click and conversion performance by asset |
| get_client_snapshot | Multi-source overview: conversations, appointments, revenue, ads, SEO, content in one call |
Intelligence & Optimization
| Tool | What It Does |
|---|
| get_work_items | Prioritized action items from the revenue intelligence inbox. Items may include target_step_id for lifecycle-aware task routing. |
| get_insights | AI-generated insights: competitor gaps, audience expansions, messaging wins, ad refresh proposals |
| get_test_runs | Active experiments and A/B test results with confidence scores |
| get_confirmed_learnings | Proven messaging patterns validated by 2+ independent wins |
| create_work_item_rest | Create work items with quality gates (confidence, evidence, action specificity) |
| update_work_item | Approve, dismiss, or snooze work items |
| update_content_opportunity | Accept or dismiss content opportunities |
| get_runner_stats | Runner effectiveness: win rate, deploy rate, dismiss rate |
| get_next_actions | Prioritized recommended actions across work items, opportunities, reviews, and experiments |
Entities now include a lifecycle_state field via query_data, tracking where each asset sits in its creation lifecycle (setup, outline, draft, review, published). Use this to filter for in-progress or stalled assets.
Brand & Style
| Tool | What It Does |
|---|
| get_brand_position | Brand positioning: identity, audience archetype, differentiators, proof points, core message |
| get_brand_guidelines | Editorial and brand guidelines (tone, style, formatting, visual identity) |
| get_icps_detailed | Full ICP profiles: demographics, pain points, goals, objections, buying triggers |
| get_messaging_learnings | Confirmed messaging learnings sorted by confidence |
| get_hooks_and_angles | Active messaging hooks (attention-grabbers) and angles (persuasive frames) |
| get_operating_profile | Website operating context: vertical, primary KPI, funnel configuration |
| get_design_tokens | Typography and color design tokens for brand-consistent design |
| list_color_palettes | Color palettes with primary, accent, trim, shadow, and ground colors |
| list_image_styles | Image styles defining aesthetic direction (composition, mood, lighting) |
| list_brand_subjects | Brand subjects (characters, mascots, products) with appearance details |
| generate_brand_image | Generate on-brand images using styles, subjects, and reference images |
GoHighLevel (GHL) Data
| Tool | What It Does |
|---|
| get_ghl_agents | View GHL AI agent configurations and active prompt versions |
| list_conversations | Browse GHL conversation threads with filtering by agent and outcome |
| get_conversation_messages | Get all messages within a conversation thread |
| list_appointments | View booked appointments with status and linked conversation context |
| list_pipeline_stages | Pipeline stage definitions with outcome mappings |
| list_ghl_opportunities | Pipeline opportunities with revenue and linked conversations |
Skills
| Tool | What It Does |
|---|
| list_skills | Browse published skills with descriptions and input requirements |
| get_skill_detail | Full skill detail including instructions, dependencies, and inputs |
| execute_skill | Assemble skill context with resolved data dependencies for execution |
Chat History
| Tool | What It Does |
|---|
| list_chat_sessions | Browse recent workspace chat sessions (metadata only) |
| get_chat_conversation_detail | Get full message history for a specific chat session |
Lifecycle Management
| Tool | What It Does |
|---|
| get_lifecycle_status | Current lifecycle step, checklist state, and completed steps for any entity |
| validate_publish_readiness | Check if all pre-publish criteria are met — returns blockers if not |
| advance_lifecycle | Re-evaluate criteria and advance to next step if current step is complete |
| skip_lifecycle_step | Skip an optional lifecycle step (required steps cannot be skipped) |
| Tool | What It Does |
|---|
| push_to_platform_rest | Push to 9 platforms (WordPress, Google Ads, Meta Ads, GHL, Elementor, Slack, Social, Pinterest, Figma) with risk gating |
| update_content_asset | Update content asset sections, SEO fields, or body |
| manage_content_sections | Reorder, merge, split, delete, or rename content sections |
| create_cta_rest | Create a CTA attached to a content asset |
| update_cta | Update CTA headline, body, button text, or position |
| create_ad_creative_rest | Create ad creative for Google or Meta Ads |
| create_entity_rest | Create hooks, angles, offers, or stories with semantic dedup |
| update_entity_metadata_rest | Update entity classification metadata |
| create_social_post_rest | Create social posts for 6 platforms |
| schedule_social_post_rest | Schedule social post with date/time validation |
| create_nurture_sequence | Create a new nurture email/SMS sequence |
| create_nurture_step | Add a step to an existing nurture sequence |
SEO Research
These tools consume Ahrefs API credits. Batch keywords into single calls rather than querying one at a time.
| Tool | What It Does |
|---|
| get_keyword_ideas | Ahrefs keyword expansion from seed terms (costs credits — batch in one call) |
| get_keyword_metrics_bulk | Volume, difficulty, CPC, traffic potential for keyword list |
| get_serp_analysis | SERP features and top results for a keyword |
| get_competitor_keywords | Competitor domain organic keyword gaps |
SEO research tools consume Ahrefs API credits. Batch keywords into single calls rather than querying one at a time.
Data Sync & Export
| Tool | What It Does |
|---|
| trigger_integration_sync | Force refresh data from GSC, GA4, Google Ads, Meta Ads, GHL, or GBP |
Integrations
| Tool | What It Does |
|---|
| get_wordpress_status | WordPress connection state, Elementor availability, last sync time |
Example Prompts
Once connected, try asking Claude:
Getting started:
- “List my websites” — discover your website IDs
- “Give me a summary of the Acme Corp website”
Content:
- “Show me all blog posts that are in Review status”
- “What content opportunities have the highest priority right now?”
- “Search for content about pricing strategies”
Ads analysis:
- “Show me all ad campaigns and their ROAS”
- “What are the top-performing ad creatives by CTR this month?”
- “Show me the targeting for our Meta ad sets”
- “Give me a keyword summary for the last 90 days”
- “What search terms are driving the most conversions?”
- “Show me daily performance trends for campaign X over the last 30 days”
Generation:
- “Generate a hero image for our new product page — use our primary brand style”
- “Generate 3 variations of a Meta ad for our spring campaign”
- “Create a blog post about cloud migration for IT directors”
Intelligence:
- “What are our top confirmed learnings from the last month?”
- “Show me the active experiments and their results”
- “What work items should we prioritize this week?”
Brand & style:
- “What are our brand guidelines?”
- “Show me our ICP profiles”
- “List our image styles and generate an image using the editorial style”
Lifecycle:
- “What step is the wedding pricing blog at in its lifecycle?”
- “Is this blog ready to publish?”
Platform push:
- “Publish this blog to WordPress”
- “Pause the underperforming Google Ads creative”
SEO Research:
- “Find keyword ideas around ‘wedding venue marketing’”
- “What SERP features exist for ‘the knot advertising cost’?”
Recommendations:
- “What should I work on next?”
- “Show me the top priority actions for this week”
Skills:
- “List all available skills for this website”
- “Execute the ad-spend-analyst skill for Google Ads with a 30-day lookback”
When you first connect, ask Claude to list your websites — this helps it discover your website ID, which is required for most other tools.
How Access Works
The MCP connection uses OAuth 2.1 with PKCE — the same secure flow used by services like Google and GitHub.
- Your identity: The connection is tied to your WisePilot user account. Claude can only access websites where you are a member.
- Website-scoped: All data access is scoped to individual websites. If you’re a member of multiple websites, Claude can access them all.
- Role-enforced: Your role on each website determines what you can do. Viewers can browse; Editors and above can generate content and images.
- Token-based: Access tokens expire after 1 hour and automatically refresh. No passwords or API keys are stored by Claude.
Revoking Access
To disconnect Claude from your WisePilot account:
- Log in to WisePilot
- Navigate to Integrations in the sidebar
- Find the active OAuth session and revoke it
You can also remove the integration from Claude’s settings directly.
Troubleshooting
”Unauthorized” or “Access denied” errors
- Your access token may have expired. Disconnect and reconnect the integration in Claude’s settings.
- Verify your WisePilot account is active and you’re a member of at least one website.
- Generation tools require Editor role or higher. Check your role under Settings > Team & Roles in WisePilot, or ask your admin to upgrade your access.
- Verify the integration is listed in Claude’s settings as connected.
- Try refreshing or restarting Claude.
- Make sure you completed the OAuth consent step (clicked Allow).
Wrong website data
- If you have access to multiple websites, tell Claude which one to use: “Use the Acme Corp website” or provide the website ID directly.
- Ask Claude to
list_websites to see all available options.
