Multi-MCP Examples

Real-world examples of combining Suparank with external MCPs

Learn by Example

These examples show practical workflows combining Suparank with popular MCPs. Copy and adapt the configurations for your own use cases.

Example 1: SEO-Driven Content Creation

Combine SEO research MCP with Suparank for data-driven content that targets real search opportunities.

Setup

~/.suparank/credentials.jsonjson

{
  "external_mcps": [
    {
      "name": "seo-research-mcp",
      "description": "Real keyword data from Ahrefs API",
      "available_tools": ["get_keyword_data", "analyze_serp", "get_backlinks"]
    }
  ],
  "tool_instructions": [
    {
      "tool_name": "keyword_research",
      "composition_hints": "Use seo-research-mcp's get_keyword_data for real search volumes before generating strategy."
    }
  ]
}

Workflow

1User: "Create content about React hooks"

2AI calls seo-research-mcp → get_keyword_data("react hooks")

3Gets real data: { volume: 74000, difficulty: 45 }

4AI calls Suparank → keyword_research with real data

5AI calls Suparank → content_write with optimized keywords

ResultContent targeting actual search opportunities

Example 2: Competitor Analysis Workflow

Use Firecrawl to analyze top-ranking competitors before writing content.

Setup

{
  "external_mcps": [
    {
      "name": "firecrawl-mcp",
      "description": "Web scraping for competitor analysis",
      "available_tools": ["scrape_url", "crawl_site", "extract_content"]
    }
  ],
  "tool_instructions": [
    {
      "tool_name": "content_write",
      "composition_hints": "Scrape top 3 ranking pages with firecrawl-mcp. Analyze headings, word count, and topics covered."
    }
  ]
}

Workflow

1User: "Write a guide about TypeScript generics"

2AI searches Google for top-ranking pages

3AI calls firecrawl-mcp → scrape_url on top 3 results

4AI analyzes: avg word count (2500), common H2s, topics

5AI calls Suparank → content_write with insights

ResultContent that matches or exceeds competitor quality

Example 3: Full Research Pipeline

Combine multiple MCPs for comprehensive research and authoritative content.

Setup

{
  "external_mcps": [
    {
      "name": "seo-research-mcp",
      "description": "Keyword and SERP data",
      "available_tools": ["get_keyword_data", "analyze_serp", "get_backlinks"]
    },
    {
      "name": "firecrawl-mcp",
      "description": "Web scraping",
      "available_tools": ["scrape_url", "extract_content"]
    },
    {
      "name": "perplexity-mcp",
      "description": "AI-powered research",
      "available_tools": ["search", "summarize"]
    }
  ],
  "tool_instructions": [
    {
      "tool_name": "keyword_research",
      "composition_hints": "1. Use seo-research-mcp for volume. 2. Use perplexity-mcp for trends."
    },
    {
      "tool_name": "content_write",
      "composition_hints": "1. Use firecrawl-mcp for competitors. 2. Use perplexity-mcp for facts."
    }
  ]
}

Workflow

1User: "Create authoritative content about AI agents"

2AI calls seo-research-mcp → get_keyword_data

3AI calls perplexity-mcp → search for trends

4AI calls Suparank → keyword_research

5AI calls firecrawl-mcp → scrape competitors

6AI calls Suparank → content_write

7AI calls perplexity-mcp to fact-check claims

ResultWell-researched, SEO-optimized, accurate content

Example 4: Local + Cloud Hybrid

Use local file system MCP alongside cloud MCPs for content library management.

Setup

{
  "external_mcps": [
    {
      "name": "filesystem-mcp",
      "description": "Local file access",
      "available_tools": ["read_file", "write_file", "list_directory"]
    },
    {
      "name": "seo-research-mcp",
      "description": "Cloud SEO data",
      "available_tools": ["get_keyword_data"]
    }
  ],
  "tool_instructions": [
    {
      "tool_name": "content_write",
      "composition_hints": "Check filesystem-mcp for existing content. Avoid duplicating existing articles."
    }
  ]
}

Workflow

1User: "Write about Next.js App Router"

2AI calls filesystem-mcp → list_directory("content/")

3AI finds existing articles, identifies content gaps

4AI calls seo-research-mcp → get_keyword_data

5AI calls Suparank → content_write (fills gaps)

6AI calls filesystem-mcp → write_file (saves draft)

ResultContent that complements existing library

Tips for Multi-MCP Workflows

Order Matters

Research MCPs → Strategy tools → Content creation → Publishing

Data Flow

Pass data from external MCPs into Suparank tools for better results

Error Handling

If an external MCP fails, the AI should continue with available data

Performance

Minimize external API calls by batching requests when possible