Sign inStart free
MCP Protocol v2024-11-05 Stdio & WebStandard HTTP 26 Tools · 5 Resources · 4 Prompts

Redtoolz MCP Server & AI Connectors

Standardized, type-safe Model Context Protocol tools to command Google Business Profiles, customer review streams, and Meta automations from Claude, Cursor, and Antigravity.

Quick Start Setup Explore 26 Tools
Instant Connection

Quick Start Setup

The Redtoolz MCP server operates in dual modes: stdio transport for local developer IDEs and desktop assistants, and WebStandard Streamable HTTP for remote agent clouds.

Target Config File:
Windows: %APPDATA%\Claude\claude_desktop_config.jsonmacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.jsonstdio transport
{
  "mcpServers": {
    "redtoolz": {
      "command": "node",
      "args": [
        "--import",
        "./scripts/audit-typescript-loader.mjs",
        "scripts/start-mcp.mjs"
      ],
      "cwd": "/path/to/redtoolz",
      "env": {
        "DATABASE_URL": "mysql://USER:PASSWORD@127.0.0.1:3306/redtoolz_db",
        "REDTOOLZ_ORG_ID": "your-organization-uuid",
        "NODE_ENV": "development"
      }
    }
  }
}
Enterprise Safety

Security, RBAC & Circuit Breakers

Every tool execution is enforced by strict tenant isolation, authenticated bearer tokens, and platform safeguards.

Tenant Scoping

Agents operate strictly inside their authorized Organization UUID. Cross-tenant data leakage is cryptographically and logically prohibited.

Bearer Token Auth

Remote agents authenticate with rtz_live_... API keys, verified against workspace entitlements on every call.

Circuit Breakers

Platform kill-switches fail closed. If an admin disables publishing or automation, agent tool mutations halt immediately with safety notices.

/
Jump to Suite:
Customer Trust

Google Reviews & Reputation Suite (5 Tools)

Stream reviews, craft brand-aligned responses, publish replies, and inspect private negative feedback.

reviews_fetch_stream
Read / Filter

Fetch live customer reviews across Google Business Profile locations with rating, response status, and sentiment filtering.

ParameterTypeRequiredDescription
locationIdstringOptionalFilter reviews by specific connected Google Location UUID.
statusstringOptionalOne of: 'all', 'unanswered', 'answered'. Default: 'unanswered'.
minRating / maxRatingnumberOptionalRating range from 1 to 5 stars.
limitnumberOptionalMax reviews to return (1-50, default: 20).
reviews_generate_ai_reply
AI Synthesis

Generate 3 tailored, brand-compliant speech-bubble reply options for a customer review using Brand Voice and offerings context.

ParameterTypeRequiredDescription
reviewIdstringRequiredUUID of the target Google review to respond to.
toneOverridestringOptionalOptional nuance override (e.g. 'empathetic', 'enthusiastic').
reviews_publish_reply
Write / Publish

Post an approved owner reply to Google Business Profile for public display on Google Maps.

ParameterTypeRequiredDescription
reviewIdstringRequiredUUID of the target review in Redtoolz database.
replyTextstringRequiredThe approved final reply copy to transmit to Google API.
reviews_get_private_feedback
Read / Intercept

Inspect private negative feedback submissions intercepted by Smart QR Campaigns before they reach Google Maps.

ParameterTypeRequiredDescription
locationIdstringOptionalOptional filter by location UUID.
limitnumberOptionalMax feedback entries to return (default: 20).
reviews_list_campaigns
Read / Config

List all Smart QR Review campaigns with short URL slugs, QR scans, and conversion routing configurations.

ParameterTypeRequiredDescription
locationIdstringOptionalOptional filter by location UUID.
statusstringOptionalFilter by status: 'active', 'paused', or 'all'.
Local Search Dominance

Google Business Profile & SEO Suite (5 Tools)

Manage physical locations, services catalog, Google Local updates, and SEO health audits.

gbp_list_locations
Read / Directory

List all connected Google Business Profile locations with their Google Place ID, verification state, and review counts.

ParameterTypeRequiredDescription
pagenumberOptionalPage offset index (default: 1).
pageSizenumberOptionalNumber of locations per page (default: 25).
gbp_get_location_details
Read / Details

Fetch full Google Business location details including primary/additional categories, address, phone, website, and operating hours.

ParameterTypeRequiredDescription
locationIdstringRequiredUUID of the location in Redtoolz.
gbp_manage_services
Read / Write

List, add, or delete service catalog items on Google Maps with fixed/starting price types and 300-character descriptions.

ParameterTypeRequiredDescription
actionstringRequiredOne of: 'list', 'add', 'delete'.
locationIdstringRequiredUUID of the target Google Business location.
serviceItemobjectOptionalFor 'add': { serviceName, categoryName, priceType, price, description }.
serviceIdstringOptionalFor 'delete': ID of the service catalog entry to remove.
gbp_publish_local_post
Write / Publish

Publish standard Local Updates, promotional Offers, or Events directly to Google Business Profile for Google Maps discovery.

ParameterTypeRequiredDescription
locationIdstringRequiredUUID of the target location.
summarystringRequiredPost content / caption (max 1500 chars).
topicTypestringOptional'STANDARD', 'OFFER', or 'EVENT'. Default: 'STANDARD'.
actionTypestringOptionalCall-to-Action button: 'BOOK', 'ORDER', 'SHOP', 'LEARN_MORE', 'SIGN_UP', 'CALL'.
actionUrlstringOptionalDestination target URL for the CTA button.
gbp_get_seo_audit
Audit / SEO

Run an automated local SEO audit evaluating profile completeness, photos count, reviews velocity, and 3-pack ranking health.

ParameterTypeRequiredDescription
locationIdstringRequiredUUID of the location to evaluate.
Conversational Funnels

Meta Social Automation Hub (6 Tools)

Automate Instagram & Facebook comments, ManyChat-style follow-to-unlock DM funnels, and real-time execution logs.

social_list_channels
Read / Channels

List connected Facebook Pages and Instagram Business accounts with token health, permissions, and active automation rules summary.

ParameterTypeRequiredDescription
platformstringOptional'all', 'facebook', or 'instagram'. Default: 'all'.
social_create_auto_reply_rule
Write / Automate

Create automated comment reply rules triggered by keywords with intelligent AI response variations.

ParameterTypeRequiredDescription
channelIdstringRequiredUUID of the Facebook Page or Instagram Account.
keywordsstring[]RequiredArray of trigger keywords (e.g. ['price', 'cost', 'info']).
replyTemplatesstring[]RequiredArray of rotating reply variations.
isAiAssistedbooleanOptionalEnable dynamic AI tone alignment. Default: false.
social_create_comment_to_dm_rule
Write / DM Funnel

Create Comment-to-DM funnels: when a user comments a keyword on a post/reel, dispatch an immediate direct message.

ParameterTypeRequiredDescription
channelIdstringRequiredUUID of the Instagram/Facebook channel.
triggerKeywordstringRequiredKeyword that triggers the DM (e.g. 'LINK').
dmTemplatestringRequiredDirect message copy to send to the commenter.
social_configure_follow_to_unlock
Write / Viral Growth

Configure high-converting 3-bubble conversational DM flows that verify user follow status before unlocking lead magnets.

ParameterTypeRequiredDescription
channelIdstringRequiredUUID of the Instagram Business account.
triggerKeywordstringRequiredTrigger word on reels/posts (e.g. 'FREEBIE').
assetDownloadUrlstringRequiredLead magnet download link to unlock.
followCheckMessagestringOptionalCustom prompt urging the user to follow first.
social_toggle_automation_rule
Control / Toggle

Activate, pause, or archive any comment or DM automation rule instantly.

ParameterTypeRequiredDescription
ruleIdstringRequiredUUID of the automation rule.
enabledbooleanRequiredTrue to activate, false to pause.
social_get_activity_timeline
Read / Audit

Inspect execution history for comment replies, delivered DMs, conversion events, and error logs.

ParameterTypeRequiredDescription
channelIdstringOptionalOptional channel UUID filter.
limitnumberOptionalMax logs to retrieve (default: 50).
Multi-Channel Publishing

Canonical Content Studio Suite (4 Tools)

Draft, schedule, approve, and deliver unified posts across Google Business, Facebook, and Instagram.

content_create_item
Write / Draft

Create unified canonical content items targeting multiple channels with localized variations and scheduled delivery.

ParameterTypeRequiredDescription
titlestringRequiredInternal working title for the content item.
bodystringRequiredCore post copy / caption.
targetChannelsstring[]RequiredArray of channel UUIDs (Facebook, Instagram, GBP).
scheduledForstringOptionalISO 8601 timestamp for future scheduled publication.
content_approve_or_reject
Workflow / Approval

Enforce workflow controls: approve queued drafts for publishing or reject with actionable revision feedback.

ParameterTypeRequiredDescription
contentIdstringRequiredUUID of the content item.
decisionstringRequired'approved' or 'rejected'.
reviewNotesstringOptionalExplanation or instructions for revisions.
content_list_scheduled
Read / Calendar

List scheduled posts across all channels within a date range for editorial calendar review.

ParameterTypeRequiredDescription
startDate / endDatestringOptionalISO 8601 date boundary range.
statusstringOptional'scheduled', 'published', 'failed', or 'all'.
content_retry_delivery
Ops / Recovery

Retry failed destination dispatches via Publishing Engine V2 with automatic backoff.

ParameterTypeRequiredDescription
targetIdstringRequiredUUID of the destination target row from content_targets.
Consistency & Governance

Brand Voice & Safety Suite (3 Tools)

Access 7-tier brand guidelines, manage tone parameters, and run automated Brand Guardian safety scans.

brand_get_voice_context
Read / Brand

Retrieve complete brand voice guidelines: tone attributes, vocabulary to avoid, target persona, and core offerings.

ParameterTypeRequiredDescription
brandIdstringOptionalOptional brand UUID. Defaults to primary brand.
brand_update_voice_context
Write / Snapshot

Update brand parameters and automatically create an immutable historical version snapshot in brand_context_versions.

ParameterTypeRequiredDescription
brandIdstringRequiredUUID of the brand to update.
toneAttributesstring[]OptionalArray of approved tone descriptors.
forbiddenPhrasesstring[]OptionalBanned words or competitor mentions.
changeReasonstringOptionalAudit trail log reason for this revision.
brand_guardian_check
Safety / AI Guard

Screen proposed copy or review replies against Brand Guardian rules: check banned words, compliance risks, and tone divergence.

ParameterTypeRequiredDescription
proposedTextstringRequiredThe content or reply draft to evaluate.
channelstringOptionalDestination: 'google_maps', 'instagram', or 'facebook'.
brandIdstringOptionalOptional brand UUID context.
Workspace Reliability

Operations & Quota Guard Suite (3 Tools)

Monitor plan quotas, system alerts, and platform kill switches.

workspace_get_quota_status
Telemetry / Quota

Check subscription tier, remaining destination slots, monthly post quotas, and AI reply token usage.

This tool takes no required arguments. It evaluates live workspace state context automatically.
action_center_get_alerts
Alerts / Health

Retrieve urgent operational alerts: disconnected channels, expired Meta tokens, and critical publishing errors.

ParameterTypeRequiredDescription
severitystringOptional'all', 'critical', or 'warning'. Default: 'all'.
system_check_kill_switches
Safety / Controls

Inspect administrative circuit breakers to verify whether publishing, automation, or AI features are active.

This tool takes no required arguments. It evaluates live workspace state context automatically.
Real-Time Context

Ambient Resources (5 URIs)

Resources provide ambient read-only context to AI models without requiring explicit tool execution.

Resource URIMIME TypePurpose
redtoolz://workspace/health
application/jsonCurrent workspace health, quota utilization, and active alerts.
redtoolz://brands/{brandId}/voice
application/jsonLive Brand Voice context and guidelines for a specific brand profile.
redtoolz://locations/{locationId}/reviews/unanswered
application/jsonList of pending unanswered reviews awaiting merchant reply.
redtoolz://content/calendar/upcoming
application/jsonUpcoming scheduled posts across all connected channels for the next 7 days.
redtoolz://social/activity-timeline
application/jsonRecent social automation events, comment replies, and DM executions.
Pre-Engineered Agent Workflows

Guided Prompts (4 Workflows)

Invoke these prompt templates in Claude or Cursor for end-to-end automation with a single sentence.

review-inbox-zero
Prompt Template

Scans all pending Google reviews, analyzes sentiment, drafts empathetic responses for critical reviews and warm replies for 5-star reviews, and prepares them for 1-click approval.

“Run review-inbox-zero. Scan unanswered reviews and draft brand-aligned responses for my review.”
social-campaign-autopilot
Prompt Template

Plans and schedules an editorial calendar for an upcoming promotion across Instagram, Facebook, and Google Business with Brand Guardian compliance checks.

“Run social-campaign-autopilot for our summer menu launch next week. Adhere strictly to our Brand Voice.”
instagram-viral-lead-magnet
Prompt Template

Sets up a ManyChat-style keyword trigger with a 3-bubble conversational follow-to-unlock DM flow delivering a downloadable asset link.

“Configure an Instagram automation: when users comment 'GUIDE', trigger our 3-bubble follow-to-unlock funnel with our PDF link.”
gbp-local-seo-doctor
Prompt Template

Audits your primary Google Business Profile, identifies missing attributes or unserved categories, and drafts a keyword-rich Google Local Update post.

“Run gbp-local-seo-doctor on our main location and suggest optimizations to boost our 3-pack ranking.”
Automated Verification

Local Testing & Verification

Redtoolz includes an automated 12-point MCP test suite covering tool registration, resource resolution, and prompt synthesis.

Terminal Commandsnpm scripts
# Run the comprehensive MCP automated test suite (12/12 passing)
npm run mcp:test

# Start the interactive stdio server directly
npm run mcp:start
Ready to empower your AI agents?Connect your Google Business and Meta channels in Redtoolz and start commanding them with Claude, Cursor, and Antigravity.