MCP Server Examples

Practical examples of using the Hello Battle Card MCP server with AI agents.

Overview

These examples show how AI agents like ChatGPT and Claude can use the MCP server tools to answer questions about your competitive intelligence data. Each example includes the conversation flow and the underlying tool calls.

Example 1: Getting Competitor Information

User Question: "Tell me about Acme Corp"

AI Agent Response: "I'll get the details about Acme Corp for you."

Tool Call:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_competitor",
    "arguments": {
      "competitorId": "acme-corp-id"
    }
  }
}

AI Agent Response: "Acme Corp is a competitor in your workspace. Here's what I found:

Status: COMPLETE (analysis finished)
Website: https://acme.com
Last refreshed: 2 weeks ago
Products: They offer 3 main products
Categories: Pricing, Features, Integrations, Security

Would you like me to get their battlecard or compare them in a matrix?"

Example 2: Listing Competitors for a Product

User Question: "Who are our competitors for Product X?"

AI Agent Response: "Let me find all competitors associated with Product X."

Tool Call:

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "list_competitors",
    "arguments": {
      "productId": "product-x-id"
    }
  }
}

AI Agent Response: "I found 5 competitors for Product X:

Acme Corp - Status: COMPLETE
Beta Inc - Status: COMPLETE
Gamma LLC - Status: PROCESSING
Delta Corp - Status: COMPLETE
Epsilon Ltd - Status: COMPLETE

Would you like battlecards or a matrix comparison for any of these?"

Example 3: Getting Battlecard Content

User Question: "What are our talking points against Acme Corp for Product X?"

AI Agent Response: "I'll get the battlecard for Acme Corp vs Product X."

Tool Call:

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "get_battlecard",
    "arguments": {
      "competitorId": "acme-corp-id",
      "productId": "product-x-id"
    }
  }
}

AI Agent Response: "Here are your key talking points against Acme Corp:

Why We Win:

Superior Integration Capabilities - We offer 50+ integrations vs their 20
Better Pricing Model - Our usage-based pricing is more flexible
Advanced Security Features - We have SOC 2 Type II certification

Talking Points:

'Our platform integrates with your entire tech stack, reducing implementation time by 60%'
'Our flexible pricing scales with your usage, so you only pay for what you need'
'Security is built-in from the ground up, not bolted on'

Objections to Expect:

'Acme Corp has been around longer' → Response: 'While they're established, we've learned from their mistakes and built a more modern platform'

Would you like me to get the evidence sources for any of these claims?"

Example 4: Matrix Comparison (basic cells)

User Question: "How do we compare to Acme Corp and Beta Inc across all categories?"

AI Agent Response: "I'll fetch matrix cells for Acme Corp and Beta Inc."

Tool Call:

{
  "jsonrpc": "2.0",
  "id": 4,
  "method": "tools/call",
  "params": {
    "name": "get_matrix",
    "arguments": {
      "productId": "product-x-id",
      "competitorIds": ["acme-corp-id", "beta-inc-id"],
      "includeOurProduct": true
    }
  }
}

AI Agent Response: "I retrieved matrix cells with capability statuses and evidence IDs. I can summarize:

Pricing: Acme (MATCH), Beta (INFERIOR)
Integrations: Acme (SUPERIOR), Beta (MATCH)
Security: Acme (MATCH), Beta (MATCH)

These cells include evidence IDs. Want me to pull evidence for any category or use the REST Matrix API for full category and competitor metadata?"

Example 5: Searching Intel

User Question: "What do we know about Acme Corp's pricing?"

AI Agent Response: "I'll search our intelligence database for pricing information about Acme Corp."

Tool Call:

{
  "jsonrpc": "2.0",
  "id": 5,
  "method": "tools/call",
  "params": {
    "name": "search_intel",
    "arguments": {
      "query": "pricing",
      "competitorId": "acme-corp-id",
      "limit": 5
    }
  }
}

AI Agent Response: "I found 5 relevant pieces of intelligence about Acme Corp's pricing:

Pricing Page Analysis (Credibility: 95%)
- They offer 3 tiers: Starter ($99/mo), Pro ($299/mo), Enterprise (custom)
- Annual billing gets 20% discount
- Source: https://acme.com/pricing
Review Mention (Credibility: 85%)
- Customer mentioned pricing increased 15% last year
- Some customers find it expensive compared to alternatives
- Source: G2 Review
News Article (Credibility: 90%)
- Company announced new pricing model in Q2
- Focus on value-based pricing for enterprise
- Source: TechCrunch article

Would you like me to get the full content of any of these sources?"

Example 6: Triggering Refresh

User Question: "Refresh the data for Acme Corp, I think they launched new features"

AI Agent Response: "I'll trigger a refresh job to collect the latest intelligence about Acme Corp."

Tool Call:

{
  "jsonrpc": "2.0",
  "id": 6,
  "method": "tools/call",
  "params": {
    "name": "trigger_refresh",
    "arguments": {
      "competitorId": "acme-corp-id"
    }
  }
}

AI Agent Response: "I've started a refresh job for Acme Corp. The job ID is job-12345.

The refresh process will:

Collect latest intelligence from their website
Process and categorize new information
Update their company profile
Refresh matrix comparisons
Regenerate battlecards if needed

This typically takes 2-5 minutes. Would you like me to check the job status in a few minutes?"

Example 7: Generating Battlecard

User Question: "Generate a new battlecard for Beta Inc vs Product Y"

AI Agent Response: "I'll generate a fresh battlecard for Beta Inc against Product Y."

Tool Call:

{
  "jsonrpc": "2.0",
  "id": 7,
  "method": "tools/call",
  "params": {
    "name": "generate_battlecard",
    "arguments": {
      "competitorId": "beta-inc-id",
      "productId": "product-y-id"
    }
  }
}

AI Agent Response: "I've started generating a new battlecard. The job ID is job-67890.

Battlecard generation includes:

Analysis of competitive positioning
Identification of key differentiators
Creation of talking points
Objection handling strategies
Evidence-backed claims

This typically takes 1-3 minutes. The battlecard will be ready shortly. Would you like me to notify you when it's complete?"

Example 8: Complex Analysis

User Question: "Compare our top 3 competitors and tell me where we should focus our sales efforts"

AI Agent Response: "Let me analyze your top competitors and provide strategic recommendations."

Multiple Tool Calls:

// Get all competitors
{
  "name": "list_competitors",
  "arguments": {}
}

// Get matrix for each
{
  "name": "get_matrix",
  "arguments": {
    "productId": "product-x-id",
    "competitorIds": ["comp1", "comp2", "comp3"],
    "includeOurProduct": true
  }
}

// Get battlecards
{
  "name": "get_battlecard",
  "arguments": {
    "competitorId": "comp1",
    "productId": "product-x-id"
  }
}
// ... repeat for comp2 and comp3

AI Agent Response: "Based on my analysis of your top 3 competitors, here's where you should focus:

Competitor 1 (Acme Corp):

Your strengths: Pricing, Integrations, Security
Your weaknesses: Brand recognition, Market presence
Focus: Emphasize value and technical superiority

Competitor 2 (Beta Inc):

Your strengths: Features, Support, Scalability
Your weaknesses: Pricing, Ease of use
Focus: Target enterprise deals where features matter more

Competitor 3 (Gamma LLC):

Your strengths: All categories
Your weaknesses: None significant
Focus: Differentiate on innovation and roadmap

Strategic Recommendations:

Pricing Advantage: Lead with value proposition against Acme Corp
Feature Depth: Target complex enterprise deals vs Beta Inc
Innovation: Emphasize roadmap and new capabilities vs Gamma LLC

Would you like detailed battlecards for any specific competitor?"

Example Prompts for AI Agents

Here are example prompts you can use with your AI agent:

Competitive Analysis

"List all my competitors and their status"
"Compare me to Competitor X across all categories"
"What are Competitor Y's main strengths and weaknesses?"
"Get the battlecard for Competitor Z"

Sales Preparation

"What talking points should I use against Competitor X?"
"What objections will I face from Competitor Y?"
"How do we differentiate from Competitor Z?"
"Get evidence to support our pricing advantage"

Intelligence Gathering

"Search for information about Competitor X's pricing"
"What do we know about Competitor Y's new features?"
"Find recent news about Competitor Z"
"Get all intel items for Competitor X"

Strategic Planning

"Who are our top competitors and how do we compare?"
"Where should we focus our product development?"
"What are the main competitive trends?"
"Generate battlecards for all our competitors"

Best Practices

Clear Questions

Be specific about which competitor or product
Ask focused questions rather than broad ones
Provide context when needed

Follow-up Questions

Build on previous answers
Ask for evidence when claims are made
Request more detail on specific points

Tool Combinations

Combine multiple tools for comprehensive analysis
Use search before getting detailed data
Get battlecards after matrix analysis

Error Handling

AI agents should handle errors gracefully
Verify competitor/product IDs exist
Check job status for async operations

Solution Management Examples

List All Solutions

User Question: "What solutions do we have configured?"

AI Agent Response: "I'll get all your solution themes."

Tool Call:

{
  "jsonrpc": "2.0",
  "id": 8,
  "method": "tools/call",
  "params": {
    "name": "list_solutions",
    "arguments": {}
  }
}

AI Agent Response: "You have 5 solution themes configured:

Enterprise Security - Groups security, compliance, and audit categories
Ease of Use - Combines UX and support categories
Integration Ecosystem - Focuses on integrations and APIs
Performance & Reliability - Groups performance and scalability
Value & Pricing - Pricing and ROI categories

Would you like details on any specific solution?"

Get Solution Matrix

User Question: "Show me how we compare to Competitor X across solution themes"

AI Agent Response: "I'll get the solution matrix comparing you to Competitor X."

Tool Call:

{
  "jsonrpc": "2.0",
  "id": 9,
  "method": "tools/call",
  "params": {
    "name": "get_solution_matrix",
    "arguments": {
      "competitorIds": ["competitor-x-id"],
      "solutionIds": []
    }
  }
}

AI Agent Response: "Here's how you compare to Competitor X at the solution level:

Enterprise Security: You score 3.5/4 (Strong) vs their 2.0/4 (Average)
Ease of Use: You score 4.0/4 (Excellent) vs their 3.0/4 (Good)
Integration Ecosystem: You score 2.5/4 (Good) vs their 3.5/4 (Strong)
Performance & Reliability: You score 3.0/4 (Good) vs their 3.0/4 (Good)
Value & Pricing: You score 4.0/4 (Excellent) vs their 2.5/4 (Average)

Key Insights:

Lead with Enterprise Security and Value & Pricing
They're stronger in Integration Ecosystem - be ready to address this
Ease of Use is a clear differentiator

Would you like to drill down into any specific solution to see the underlying categories?"

Create Custom Solution

User Question: "Create a solution called 'Time to Value' that includes pricing and onboarding categories"

AI Agent Response: "I'll create a new solution theme called 'Time to Value' with those categories."

Tool Call:

{
  "jsonrpc": "2.0",
  "id": 10,
  "method": "tools/call",
  "params": {
    "name": "create_solution",
    "arguments": {
      "name": "Time to Value",
      "description": "How quickly customers realize value from the product",
      "productIds": ["product-id-1"],
      "categoryMappings": [
        {
          "categoryId": "pricing",
          "productId": "product-id-1",
          "weight": 0.4
        },
        {
          "categoryId": "onboarding",
          "productId": "product-id-1",
          "weight": 0.6
        }
      ]
    }
  }
}

AI Agent Response: "I've created the 'Time to Value' solution theme. It includes:

Pricing category (40% weight)
Onboarding category (60% weight)

This solution will now appear in your solution matrix. The aggregated scores will be calculated from these category mappings with the specified weights.

Would you like me to show you the solution matrix with this new theme?"

Next Steps

MCP Tools Reference - Complete tool documentation
MCP Installation - Set up your connection
API Reference - Related REST API endpoints

Overview​

Example 1: Getting Competitor Information​

Example 2: Listing Competitors for a Product​

Example 3: Getting Battlecard Content​

Example 4: Matrix Comparison (basic cells)​

Example 5: Searching Intel​

Example 6: Triggering Refresh​

Example 7: Generating Battlecard​

Example 8: Complex Analysis​

Example Prompts for AI Agents​

Competitive Analysis​

Sales Preparation​

Intelligence Gathering​

Strategic Planning​

Best Practices​

Clear Questions​

Follow-up Questions​

Tool Combinations​

Error Handling​

Solution Management Examples​

List All Solutions​

Get Solution Matrix​

Create Custom Solution​

Next Steps​

Overview

Example 1: Getting Competitor Information

Example 2: Listing Competitors for a Product

Example 3: Getting Battlecard Content

Example 4: Matrix Comparison (basic cells)

Example 5: Searching Intel

Example 6: Triggering Refresh

Example 7: Generating Battlecard

Example 8: Complex Analysis

Example Prompts for AI Agents

Competitive Analysis

Sales Preparation

Intelligence Gathering

Strategic Planning

Best Practices

Clear Questions

Follow-up Questions

Tool Combinations

Error Handling

Solution Management Examples

List All Solutions

Get Solution Matrix

Create Custom Solution

Next Steps