Claude MCP

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

On first use, Claude Code will open a browser for OAuth authentication.

What’s Available

Recommended path: explore/query. Claude has access to 8 domain pairs ({domain}_explore + {domain}_query) plus 4 atomic orchestration tools that cover everything below. Ask Claude “what intelligence operations are available?” and it’ll call intelligence_explore() to find out. See the MCP Tool Reference for the full pattern.The individual tools below remain available for backward compatibility. New conversations should let Claude discover ops via _explore.

Discovery-first tools (recommended)

Domain	Surface
*`intelligence_`**	Lifecycle state, work items, content opportunities, AI insights, test runs, confirmed learnings, pattern candidates, attribution rollups, runner stats
*`metrics_`**	Conversations, appointments, revenue, ads, GSC, GA4, GBP, content/CTA performance, client snapshot
*`ads_`**	Creatives, ad sets, keywords, search terms — daily timeseries + summary aggregates
*`content_`**	Assets, blogs, CTAs, nurture sequences, entities, content opportunities, full-text search
*`brand_`**	Brand position, guidelines, ICPs, hooks & angles, learnings, design tokens, palettes, image styles, brand subjects
*`ghl_`**	Conversations + messages, appointments, pipeline stages, opportunities
*`seo_research_`**	Ahrefs keyword ideas, bulk metrics, SERP analysis, competitor keywords
*`integration_`**	WordPress / GHL / ad-platform connection state + sync trigger
`dispatch_lifecycle`	Open or resume a content lifecycle session — returns deep-link URL into the workspace
`promote_learning`	Promote a `pattern_candidate` to a durable confirmed learning (requires `approve`)
`request_wp_engineer_work`	File an engineering ticket into the inbox (label `engineer_work`)
`get_image_brief`	Composed brand-aligned brief for ChatGPT / Claude image gen — read-only

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)

Platform Publishing

These tools create or modify content and require Editor role or higher.

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.

”Forbidden” on generation tools

Generation tools require Editor role or higher. Check your role under Settings > Team & Roles in WisePilot, or ask your admin to upgrade your access.

Claude doesn’t show WisePilot tools

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.

Getting Started

Platform Integrations

HighLevel CRM

AI Assistants

Prerequisites

Connecting Claude to WisePilot

Claude.ai (Web)

Claude Desktop

Claude Code (CLI)

What’s Available

Discovery-first tools (recommended)

Scoping & Navigation

Content Browsing & Search

Ad Campaigns & Creatives

Google Ads Keywords & Search Terms

Generation

Metrics & Dashboards

Intelligence & Optimization

Brand & Style

GoHighLevel (GHL) Data

Skills

Chat History

Lifecycle Management

Platform Publishing

SEO Research

Data Sync & Export

Integrations

Example Prompts

How Access Works

Revoking Access

Troubleshooting

”Unauthorized” or “Access denied” errors

”Forbidden” on generation tools

Claude doesn’t show WisePilot tools

Wrong website data

​Prerequisites

​Connecting Claude to WisePilot

​Claude.ai (Web)

​Claude Desktop

​Claude Code (CLI)

​What’s Available

​Discovery-first tools (recommended)

​Scoping & Navigation

​Content Browsing & Search

​Ad Campaigns & Creatives

​Google Ads Keywords & Search Terms

​Generation

​Metrics & Dashboards

​Intelligence & Optimization

​Brand & Style

​GoHighLevel (GHL) Data

​Skills

​Chat History

​Lifecycle Management

​Platform Publishing

​SEO Research

​Data Sync & Export

​Integrations

​Example Prompts

​How Access Works

​Revoking Access

​Troubleshooting

​”Unauthorized” or “Access denied” errors

​”Forbidden” on generation tools

​Claude doesn’t show WisePilot tools

​Wrong website data

Prerequisites

Connecting Claude to WisePilot

Claude.ai (Web)

Claude Desktop

Claude Code (CLI)

What’s Available

Discovery-first tools (recommended)

Scoping & Navigation

Content Browsing & Search

Ad Campaigns & Creatives

Google Ads Keywords & Search Terms

Generation

Metrics & Dashboards

Intelligence & Optimization

Brand & Style

GoHighLevel (GHL) Data

Skills

Chat History

Lifecycle Management

Platform Publishing

SEO Research

Data Sync & Export

Integrations

Example Prompts

How Access Works

Revoking Access

Troubleshooting

”Unauthorized” or “Access denied” errors

”Forbidden” on generation tools

Claude doesn’t show WisePilot tools

Wrong website data