MCP Server

GoodBards MCP

Connect your AI assistant to GoodBards via the Model Context Protocol: your agents, your social and analytics reports, your campaigns and content, and your audience — from your favorite MCP client, one endpoint per module or all at once.

Endpoints

One server, seven endpoints. /mcp exposes every tool; what a token sees is decided by its scopes. Each module endpoint exposes only its own tools, so a client that needs one module connects to a short list: /mcp/home, /mcp/ai, /mcp/social, /mcp/campaign, /mcp/audience, /mcp/seo. Same authentication and OAuth consent on all of them.

AI agents /mcp/ai

Scope agents:invoke.

📋
listAgents
List all available AI agents for your tenant, including their capabilities and tools.
🚀
invokeAgent
Send a message to an agent and get a response. Supports continuing existing sessions.

Social media and analytics /mcp/social

Scopes reports:read (reads) and reports:write (generating a report burns connector quota).

📱
listSocialAccounts / listSocialReports / getLatestSocialReport / getSocialReport / getSocialReportStatus
The connected LinkedIn, Facebook, Instagram, X and YouTube accounts, and their stored analytics reports.
🔄
createSocialReport
Generate a fresh report for an account; poll its status, then read it.
📈
listGoogleAnalyticsProperties / runGoogleAnalyticsReport
GA4 properties connected to the account, and a report over a date range.

Campaigns and content /mcp/campaign

Scopes reports:read (reads) and content:write (creating assets, scheduling publications).

🗂
listCampaigns / getCampaign / listAssets / getAsset
Campaigns with their status, and the asset library with full content.
✍
createAsset / schedulePost
Create an asset in the library and schedule it on a campaign tactic for a real publication.
📉
campaign_analytics / campaign_metric_timeseries / refresh_campaign_analytics
The latest analytics snapshot of a campaign, KPI by KPI for the campaign and each tactic (email, social, ads, events) with the forecast; one KPI day by day; a fresh snapshot for a started campaign (reports:write).
📚
campaign_performance_history / campaign_performance_by_tactic
Past campaigns with objective, budget, tactics and headline KPIs; and one tactic code across every campaign that used it, with budget, KPIs, primary result, cost per result and averages.
🧭
plan_campaign_from_brief / get_campaign_plan
Create a campaign from a brief and let the AI plan it in the background (details, tactics as drafts, a content plan per tactic); read the plan once ready. Nothing is published.
🔗
create_short_link / list_short_links / short_link_stats
Tracked short links with UTM parameters, and their clicks per day (people only).
✉
list_sent_emails / email_engagement / email_engagers
Every email sent with its delivery counters; opens, clicks, rates, funnel, links and traffic classes of one email; who opened, clicked or bounced (audience:read, addresses masked without the sensitive-data permission).
🎟
list_events / get_event / event_registrations / event_report
Events with their status and counts, one event in detail, its registrations (audience:read), and the outcome by status, source, company and ticket type.

Home /mcp/home

Scopes reports:read and actions:write (completing an action).

🌅
get_daily_pulse / daily_pulse_history
The stored morning snapshot of the account (health, connectors, social, web, search, contacts, campaigns, events, engagement, ads, scores), latest or by date, and the last days side by side.
✅
list_actions / complete_action
The action queue with impact, effort and priority, and marking an item done.

Organic Visibility /mcp/seo

Scope reports:read. Stored results only: nothing here calls Google, scans the site or runs a model.

🌐
seo_site_profile / seo_technical_health / seo_executive_report / seo_content_plan / seo_open_issues
The tracked website and how it is read, the last technical health report, the executive summary, the content plan and the open SEO work items.

Audience /mcp/audience

Your contacts, companies and engagement data, read-only by default. Scopes: audience:read (the eight tools below) and audience:write (create_contact, update_contact_field, add_contact_note). What you see follows your GoodBards permissions: your own records when ownership is on, no email or phone without the sensitive-data permission; API keys see every record of their account but never a sensitive field.

📖
describe_audience
Tables, columns, exact values, custom fields, segments, lists and counts of your account. Call it once per conversation.
🔍
find_contacts / find_companies
Fuzzy lookup by name, email or company, tolerant to misspellings, with structured filters (status, country, job title, tag, segment, list, industry, size).
📊
audience_report
Fixed reports in one call: counts, contacts without a company, companies under a contact threshold, missing fields, unowned contacts, duplicates, by source, by industry, engagement breakdown, cold contacts, mailing lists.
🏆
rank_contacts / rank_companies
Top N by engagement score, opens, clicks or engagements over a window (human traffic only).
🧮
list_values / run_readonly_sql
Exact spellings of a categorical field, and a guarded read-only SELECT over the audience tables for anything else (single statement, your account only, 50 rows, 5 s).

Quick Start

Add this to your MCP client configuration:
{
  "mcpServers": {
    "goodbards": {
      "type": "streamable-http",
      "url": "https://mcp.goodbards.ai/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}

Claude.ai Connector (OAuth 2.1)

To connect via Claude.ai, add as a custom MCP connector:
1. URL: https://mcp.goodbards.ai/mcp (everything), or one module:
   https://mcp.goodbards.ai/mcp/home, /mcp/ai, /mcp/social, /mcp/campaign, /mcp/audience, /mcp/seo
2. Open Advanced Settings
3. Enter your Client ID and Client Secret
4. Authorize with your GoodBards API key

Server Info

Protocol MCP (Streamable HTTP)
Endpoints /mcp · /mcp/home · /mcp/ai · /mcp/social · /mcp/campaign · /mcp/audience · /mcp/seo
Authentication Bearer Token / OAuth 2.1
Version 1.0.0