BrandKarma
Remote ActiveAI GEO/SEO Agent Tools for e-Commerce
https://app.getbrandkarma.com/api/mcp/
Website
Connect to this Server
This is a remote MCP server — no local installation needed. Point your MCP client at:
https://app.getbrandkarma.com/api/mcp/ Tools (33)
update_content_idea
Updates a content idea within a plan — approve/skip ideas, add notes, set scheduled dates.
Input Schema
{
"type": "object",
"properties": {
"planId": {
"description": "Content plan ID (ObjectId)",
"type": "string"
},
"workstreamId": {
"description": "Workstream ID (GUID)",
"type": "string"
},
"ideaId": {
"description": "Content idea ID (GUID)",
"type": "string"
},
"status": {
"description": "New status: Idea, ApprovedForGeneration, Skipped",
"type": [
"string",
"null"
],
"default": null
},
"scheduledDate": {
"description": "Scheduled publication date (ISO 8601)",
"type": [
"string",
"null"
],
"default": null
},
"generationNotes": {
"description": "Notes or instructions for content generation",
"type": [
"string",
"null"
],
"default": null
},
"brief": {
"description": "Content brief (markdown) — detailed specification for the article",
"type": [
"string",
"null"
],
"default": null
}
},
"required": [
"planId",
"workstreamId",
"ideaId"
]
}
create_content_plan
Creates a new content plan and generates AI workstreams. This is an expensive operation (uses LLM credits) and may take 15-30 seconds.
Input Schema
{
"type": "object",
"properties": {
"brandId": {
"description": "Brand ID (ObjectId)",
"type": "string"
},
"startDate": {
"description": "Plan start date (ISO 8601, e.g. '2025-02-01')",
"type": "string"
},
"endDate": {
"description": "Plan end date (ISO 8601)",
"type": "string"
},
"name": {
"description": "Plan name (auto-generated if omitted)",
"type": [
"string",
"null"
],
"default": null
},
"themeFocus": {
"description": "Theme or focus area for AI generation",
"type": [
"string",
"null"
],
"default": null
},
"additionalInstructions": {
"description": "Additional instructions for the AI content planner",
"type": [
"string",
"null"
],
"default": null
}
},
"required": [
"brandId",
"startDate",
"endDate"
]
}
get_content_plan
Gets full content plan details including all workstreams and ideas.
Input Schema
{
"type": "object",
"properties": {
"planId": {
"description": "Content plan ID (ObjectId)",
"type": "string"
}
},
"required": [
"planId"
]
}
get_traffic_analytics
Gets website traffic analytics with period-over-period comparison. Returns current and previous period metrics (events, sessions, visitors, pageviews) and trends.
Input Schema
{
"type": "object",
"properties": {
"brandId": {
"description": "Brand ID (ObjectId) — used as the tracking project ID",
"type": "string"
},
"days": {
"description": "Number of days to analyze (default 7)",
"type": "integer",
"default": 7
}
},
"required": [
"brandId"
]
}
generate_content_from_item
Generates article content from a ContentItem's Brief field using AI. The item must have a Brief. Overwrites the Content field with the generated article. Use this for items created outside the plan workflow.
Input Schema
{
"type": "object",
"properties": {
"contentItemId": {
"description": "Content item ID (ObjectId)",
"type": "string"
}
},
"required": [
"contentItemId"
]
}
list_brands
Lists all brands accessible to the current tenant with their relationship type.
Input Schema
{
"type": "object",
"properties": {}
}
get_monitoring_results
Gets the latest monitoring results for a brand — aggregated sentiment, mention rank, and share of voice per provider and overall.
Input Schema
{
"type": "object",
"properties": {
"brandId": {
"description": "Brand ID (ObjectId)",
"type": "string"
}
},
"required": [
"brandId"
]
}
update_brand_keywords
Merge or replace the brand's keywords list.
Input Schema
{
"type": "object",
"properties": {
"brandId": {
"description": "Brand ID (ObjectId)",
"type": "string"
},
"keywords": {
"description": "JSON array of keyword strings",
"type": "string"
},
"mode": {
"description": "'merge' to add to existing, 'replace' to overwrite",
"type": "string",
"default": "merge"
}
},
"required": [
"brandId",
"keywords"
]
}
copy_content_to_brief
Copies the Content field of an existing ContentItem into the Brief field of a content idea. Use this to convert previously generated content into a brief for re-generation through the improved pipeline.
Input Schema
{
"type": "object",
"properties": {
"contentItemId": {
"description": "Content item ID (ObjectId) — the source to copy content from",
"type": "string"
},
"planId": {
"description": "Content plan ID (ObjectId)",
"type": "string"
},
"workstreamId": {
"description": "Workstream ID (GUID)",
"type": "string"
},
"ideaId": {
"description": "Content idea ID (GUID)",
"type": "string"
}
},
"required": [
"contentItemId",
"planId",
"workstreamId",
"ideaId"
]
}
resize_crop_image
Resizes an image to exact dimensions by cropping to fill (no letterboxing). Useful for social media sizes (e.g. 1200x630 for Open Graph, 1080x1080 for Instagram). Creates a new image — the original is kept.
Input Schema
{
"type": "object",
"properties": {
"brandId": {
"description": "Brand ID (ObjectId) for authorization",
"type": "string"
},
"imageUrl": {
"description": "Source image URL (must be a BrandKarma asset URL)",
"type": "string"
},
"width": {
"description": "Exact output width in pixels",
"type": "integer"
},
"height": {
"description": "Exact output height in pixels",
"type": "integer"
},
"format": {
"description": "Output format: png, jpg, webp (default: same as source)",
"type": [
"string",
"null"
],
"default": null
}
},
"required": [
"brandId",
"imageUrl",
"width",
"height"
]
}
update_monitored_query
Updates a monitored query — change prompt text, status, or rating. Only provided fields are changed.
Input Schema
{
"type": "object",
"properties": {
"queryId": {
"description": "Monitored query ID (ObjectId)",
"type": "string"
},
"displayName": {
"description": "New display name",
"type": [
"string",
"null"
],
"default": null
},
"prompt": {
"description": "New prompt text",
"type": [
"string",
"null"
],
"default": null
},
"status": {
"description": "New status: Auto, On, Off",
"type": [
"string",
"null"
],
"default": null
},
"rating": {
"description": "Rating (0.0-5.0) for prompt quality",
"type": [
"number",
"null"
],
"default": null
},
"industry": {
"description": "New industry",
"type": [
"string",
"null"
],
"default": null
},
"aspect": {
"description": "New aspect",
"type": [
"string",
"null"
],
"default": null
}
},
"required": [
"queryId"
]
}
list_content_plans
Lists content plans for a brand, optionally filtered by status.
Input Schema
{
"type": "object",
"properties": {
"brandId": {
"description": "Brand ID (ObjectId)",
"type": "string"
},
"status": {
"description": "Filter by status: Draft, Generating, Active, Completed, Archived",
"type": [
"string",
"null"
],
"default": null
}
},
"required": [
"brandId"
]
}
list_categories
Lists content categories for a brand. Categories are used to organize published articles.
Input Schema
{
"type": "object",
"properties": {
"brandId": {
"description": "Brand ID (ObjectId)",
"type": "string"
}
},
"required": [
"brandId"
]
}
get_content_item
Gets a content item with its full markdown body.
Input Schema
{
"type": "object",
"properties": {
"contentItemId": {
"description": "Content item ID (ObjectId)",
"type": "string"
}
},
"required": [
"contentItemId"
]
}
get_brand_timeline
Gets a unified event timeline for the brand: content publications, traffic changes, awareness changes, and monitoring run completions.
Input Schema
{
"type": "object",
"properties": {
"brandId": {
"description": "Brand ID (ObjectId)",
"type": "string"
},
"days": {
"description": "Number of days to look back (default 30)",
"type": "integer",
"default": 30
},
"eventType": {
"description": "Filter by event type: ContentScheduled, ContentPublished, ContentDraftReady, TrafficChange, AwarenessChange, MonitorRunCompleted",
"type": [
"string",
"null"
],
"default": null
}
},
"required": [
"brandId"
]
}
get_analytics_timeline
Gets brand analytics over time — one data point per monitoring run. Shows how sentiment, share of voice, and rankings change over time.
Input Schema
{
"type": "object",
"properties": {
"brandId": {
"description": "Brand ID (ObjectId)",
"type": "string"
},
"type": {
"description": "Filter by query type",
"type": [
"string",
"null"
],
"default": null
},
"industry": {
"description": "Filter by industry",
"type": [
"string",
"null"
],
"default": null
},
"aspect": {
"description": "Filter by aspect",
"type": [
"string",
"null"
],
"default": null
},
"llmProvider": {
"description": "Filter by LLM provider name",
"type": [
"string",
"null"
],
"default": null
},
"startDate": {
"description": "Start date (ISO 8601)",
"type": [
"string",
"null"
],
"default": null
},
"endDate": {
"description": "End date (ISO 8601)",
"type": [
"string",
"null"
],
"default": null
}
},
"required": [
"brandId"
]
}
approve_workstream
Approves an entire workstream — sets all 'Idea' status items to 'ApprovedForGeneration' and auto-assigns scheduled dates across the plan date range.
Input Schema
{
"type": "object",
"properties": {
"planId": {
"description": "Content plan ID (ObjectId)",
"type": "string"
},
"workstreamId": {
"description": "Workstream ID (GUID)",
"type": "string"
}
},
"required": [
"planId",
"workstreamId"
]
}
update_content_item
Partially updates a content item — only provided fields are changed.
Input Schema
{
"type": "object",
"properties": {
"contentItemId": {
"description": "Content item ID (ObjectId)",
"type": "string"
},
"title": {
"description": "New title",
"type": [
"string",
"null"
],
"default": null
},
"content": {
"description": "New markdown content",
"type": [
"string",
"null"
],
"default": null
},
"description": {
"description": "New description / excerpt",
"type": [
"string",
"null"
],
"default": null
},
"slug": {
"description": "New URL slug",
"type": [
"string",
"null"
],
"default": null
},
"status": {
"description": "New status: Draft, ReadyForReview, Published, Archived",
"type": [
"string",
"null"
],
"default": null
},
"categoryId": {
"description": "Category ID (ObjectId) — use list_categories to find available categories",
"type": [
"string",
"null"
],
"default": null
},
"primaryKeyword": {
"description": "New primary SEO keyword",
"type": [
"string",
"null"
],
"default": null
},
"tags": {
"description": "JSON array of tag strings (replaces existing)",
"type": [
"string",
"null"
],
"default": null
},
"metaTitle": {
"description": "New meta title",
"type": [
"string",
"null"
],
"default": null
},
"metaDescription": {
"description": "New meta description",
"type": [
"string",
"null"
],
"default": null
},
"imageUrl": {
"description": "New featured image URL",
"type": [
"string",
"null"
],
"default": null
},
"brief": {
"description": "Content brief (markdown)",
"type": [
"string",
"null"
],
"default": null
},
"internalTags": {
"description": "JSON array of internal tag strings (replaces existing)",
"type": [
"string",
"null"
],
"default": null
}
},
"required": [
"contentItemId"
]
}
create_content_item
Creates a new content item (article) with markdown content.
Input Schema
{
"type": "object",
"properties": {
"brandId": {
"description": "Brand ID (ObjectId)",
"type": "string"
},
"title": {
"description": "Article title (used as H1)",
"type": "string"
},
"content": {
"description": "Full article content in markdown",
"type": "string"
},
"description": {
"description": "Short description / excerpt",
"type": "string"
},
"slug": {
"description": "URL slug (auto-generated from title if omitted)",
"type": [
"string",
"null"
],
"default": null
},
"language": {
"description": "Language code (default 'en')",
"type": "string",
"default": "en"
},
"status": {
"description": "Status: Draft, ReadyForReview, Published, Archived (default Draft)",
"type": "string",
"default": "Draft"
},
"categoryId": {
"description": "Category ID (ObjectId) — use list_categories to find available categories",
"type": [
"string",
"null"
],
"default": null
},
"primaryKeyword": {
"description": "Primary SEO keyword",
"type": [
"string",
"null"
],
"default": null
},
"tags": {
"description": "JSON array of tag strings",
"type": [
"string",
"null"
],
"default": null
},
"metaTitle": {
"description": "Meta title for SEO",
"type": [
"string",
"null"
],
"default": null
},
"metaDescription": {
"description": "Meta description for SEO",
"type": [
"string",
"null"
],
"default": null
},
"imageUrl": {
"description": "Featured image URL",
"type": [
"string",
"null"
],
"default": null
},
"brief": {
"description": "Content brief (markdown) — detailed instructions for content generation",
"type": [
"string",
"null"
],
"default": null
},
"internalTags": {
"description": "JSON array of internal tag strings (private, not shown on public blog)",
"type": [
"string",
"null"
],
"default": null
}
},
"required": [
"brandId",
"title",
"content",
"description"
]
}
generate_brief_for_idea
Generates an AI content brief for a content idea using web research. The brief specifies outline, key points, tone, CTAs — everything a writer needs. Stores the result in the idea's Brief field for review before content generation.
Input Schema
{
"type": "object",
"properties": {
"planId": {
"description": "Content plan ID (ObjectId)",
"type": "string"
},
"workstreamId": {
"description": "Workstream ID (GUID)",
"type": "string"
},
"ideaId": {
"description": "Content idea ID (GUID)",
"type": "string"
}
},
"required": [
"planId",
"workstreamId",
"ideaId"
]
}
update_brand_topics
Merge or replace the brand's topics list.
Input Schema
{
"type": "object",
"properties": {
"brandId": {
"description": "Brand ID (ObjectId)",
"type": "string"
},
"topics": {
"description": "JSON array of objects with 'name' and 'priority' (0.0-1.0) fields",
"type": "string"
},
"mode": {
"description": "'merge' to add to existing, 'replace' to overwrite",
"type": "string",
"default": "merge"
}
},
"required": [
"brandId",
"topics"
]
}
create_monitored_query
Creates a new AI visibility monitoring query (prompt) for a brand.
Input Schema
{
"type": "object",
"properties": {
"brandId": {
"description": "Brand ID (ObjectId)",
"type": "string"
},
"displayName": {
"description": "Display name for this query",
"type": "string"
},
"prompt": {
"description": "The prompt text to send to LLMs",
"type": "string"
},
"queryType": {
"description": "Query type: UnaidedAwareness, Reputation, Custom",
"type": "string",
"default": "Custom"
},
"industry": {
"description": "Industry context",
"type": "string",
"default": "General"
},
"aspect": {
"description": "Aspect to focus on (optional)",
"type": [
"string",
"null"
],
"default": null
},
"status": {
"description": "Status: Auto, On, Off (default Auto)",
"type": "string",
"default": "Auto"
},
"countryCode": {
"description": "Target country code (default US)",
"type": "string",
"default": "US"
},
"languageCode": {
"description": "Target language code (default en)",
"type": "string",
"default": "en"
}
},
"required": [
"brandId",
"displayName",
"prompt"
]
}
get_brand_context
Primary entry point. Returns brand details, keywords, topics, competitors, content summary (counts by status), active plan summaries, and recent timeline events. Call this first to understand the brand before using other tools.
Input Schema
{
"type": "object",
"properties": {
"brandId": {
"description": "Brand ID (ObjectId)",
"type": "string"
}
},
"required": [
"brandId"
]
}
list_content_items
Lists content items (articles) for a brand with pagination. Excludes the full body content for performance — use get_content_item to read the full article.
Input Schema
{
"type": "object",
"properties": {
"brandId": {
"description": "Brand ID (ObjectId)",
"type": "string"
},
"status": {
"description": "Filter by status: Draft, ReadyForReview, Published, Archived",
"type": [
"string",
"null"
],
"default": null
},
"language": {
"description": "Filter by language code (e.g. 'en', 'de')",
"type": [
"string",
"null"
],
"default": null
},
"q": {
"description": "Search query to filter by title/description",
"type": [
"string",
"null"
],
"default": null
},
"page": {
"description": "Page number (default 1)",
"type": "integer",
"default": 1
},
"pageSize": {
"description": "Items per page (default 25, max 50)",
"type": "integer",
"default": 25
}
},
"required": [
"brandId"
]
}
resize_image
Resizes an existing image to fit within the given max dimensions, preserving aspect ratio. Creates a new image — the original is kept. Returns the new image URL.
Input Schema
{
"type": "object",
"properties": {
"brandId": {
"description": "Brand ID (ObjectId) for authorization",
"type": "string"
},
"imageUrl": {
"description": "Source image URL (must be a BrandKarma asset URL)",
"type": "string"
},
"maxWidth": {
"description": "Maximum width in pixels",
"type": "integer"
},
"maxHeight": {
"description": "Maximum height in pixels",
"type": "integer"
},
"format": {
"description": "Output format: png, jpg, webp (default: same as source)",
"type": [
"string",
"null"
],
"default": null
}
},
"required": [
"brandId",
"imageUrl",
"maxWidth",
"maxHeight"
]
}
crop_image
Crops an existing image to a specific rectangle region. Creates a new image — the original is kept. Returns the new image URL. Use get_image_dimensions first if you need to know the source image size.
Input Schema
{
"type": "object",
"properties": {
"brandId": {
"description": "Brand ID (ObjectId) for authorization",
"type": "string"
},
"imageUrl": {
"description": "Source image URL (must be a BrandKarma asset URL)",
"type": "string"
},
"x": {
"description": "X offset of the crop rectangle (pixels from left)",
"type": "integer"
},
"y": {
"description": "Y offset of the crop rectangle (pixels from top)",
"type": "integer"
},
"width": {
"description": "Width of the crop rectangle in pixels",
"type": "integer"
},
"height": {
"description": "Height of the crop rectangle in pixels",
"type": "integer"
},
"format": {
"description": "Output format: png, jpg, webp (default: same as source)",
"type": [
"string",
"null"
],
"default": null
}
},
"required": [
"brandId",
"imageUrl",
"x",
"y",
"width",
"height"
]
}
get_brand_analytics
Gets brand analytics: sentiment scores, share of voice, mention rankings, and competitor mentions. Aggregated across all monitoring runs with optional filters.
Input Schema
{
"type": "object",
"properties": {
"brandId": {
"description": "Brand ID (ObjectId)",
"type": "string"
},
"type": {
"description": "Filter by query type (e.g. 'UnaidedAwareness', 'Reputation')",
"type": [
"string",
"null"
],
"default": null
},
"industry": {
"description": "Filter by industry",
"type": [
"string",
"null"
],
"default": null
},
"aspect": {
"description": "Filter by aspect",
"type": [
"string",
"null"
],
"default": null
},
"llmProvider": {
"description": "Filter by LLM provider name",
"type": [
"string",
"null"
],
"default": null
},
"startDate": {
"description": "Start date (ISO 8601)",
"type": [
"string",
"null"
],
"default": null
},
"endDate": {
"description": "End date (ISO 8601)",
"type": [
"string",
"null"
],
"default": null
}
},
"required": [
"brandId"
]
}
get_image_dimensions
Returns the width and height of an image. Useful before cropping to know the valid crop area.
Input Schema
{
"type": "object",
"properties": {
"brandId": {
"description": "Brand ID (ObjectId) for authorization",
"type": "string"
},
"imageUrl": {
"description": "Image URL (must be a BrandKarma asset URL)",
"type": "string"
}
},
"required": [
"brandId",
"imageUrl"
]
}
generate_image
Generates an AI image for a brand using Nano Banana (Gemini). The prompt can be plain text OR a JSON object. When using JSON, keys are merged with the brand's default image prompt (set in BrandKit visual style), with per-image keys taking precedence. Example JSON prompt: {"motif": "Cute robots working in a garden", "aspect": "16:9"}. Returns the public URL of the generated image.
Input Schema
{
"type": "object",
"properties": {
"brandId": {
"description": "Brand ID (ObjectId)",
"type": "string"
},
"prompt": {
"description": "Image prompt — plain text or a JSON object. JSON keys merge with the brand's default image prompt.",
"type": "string"
},
"model": {
"description": "Model: 'gemini-3.1-flash-image-preview' (default, faster) or 'gemini-3-pro-image-preview' (higher quality)",
"type": [
"string",
"null"
],
"default": null
},
"aspectRatio": {
"description": "Aspect ratio: '1:1', '3:4', '4:3', '9:16', '16:9', '21:9', '2:3', '3:2', '4:5', '5:4' etc. (default: model decides)",
"type": [
"string",
"null"
],
"default": null
},
"containsText": {
"description": "Whether the image should contain rendered text (e.g. infographics). Default false.",
"type": "boolean",
"default": false
}
},
"required": [
"brandId",
"prompt"
]
}
create_category
Creates a content category for a brand. Categories are required for publishing articles. Returns the created category with its ID.
Input Schema
{
"type": "object",
"properties": {
"brandId": {
"description": "Brand ID (ObjectId)",
"type": "string"
},
"name": {
"description": "Category name (e.g. 'Industry News', 'Product Updates')",
"type": "string"
},
"description": {
"description": "Short description of what this category covers",
"type": "string"
},
"slug": {
"description": "URL slug (auto-generated from name if omitted)",
"type": [
"string",
"null"
],
"default": null
}
},
"required": [
"brandId",
"name",
"description"
]
}
generate_content_from_idea
Triggers content generation for an approved content idea. Enqueues a job that runs research, writing, and editorial review. Creates a ContentItem with the generated markdown when done.
Input Schema
{
"type": "object",
"properties": {
"planId": {
"description": "Content plan ID (ObjectId)",
"type": "string"
},
"workstreamId": {
"description": "Workstream ID (GUID)",
"type": "string"
},
"ideaId": {
"description": "Content idea ID (GUID)",
"type": "string"
}
},
"required": [
"planId",
"workstreamId",
"ideaId"
]
}
bulk_update_content_status
Batch status change for multiple content items (e.g. publish or archive several at once).
Input Schema
{
"type": "object",
"properties": {
"contentItemIds": {
"description": "JSON array of content item ID strings",
"type": "string"
},
"status": {
"description": "New status: Draft, ReadyForReview, Published, Archived",
"type": "string"
}
},
"required": [
"contentItemIds",
"status"
]
}
list_monitored_queries
Lists all monitored AI visibility prompts for a brand.
Input Schema
{
"type": "object",
"properties": {
"brandId": {
"description": "Brand ID (ObjectId)",
"type": "string"
}
},
"required": [
"brandId"
]
}
Get Verified
Add this HTML snippet to your website or README. Once verified, your server listing will receive a 'Verified' badge.
<a href="https://revuo.ai/mcp/brandkarma-4084">Listed on Revuo</a>