Appearance

Resources > AI Tools

MCP Server for Development ​

The Model Context Protocol (MCP) Server provides seamless access to Advantage documentation and codebase directly from your development environment. This powerful tool enables AI assistants to access up-to-date documentation and code examples, making development with Advantage faster and more efficient.

💡 The MCP server provides cross-repository access to always-current documentation, eliminating the need to manually search through docs or remember API details.

What is MCP? ​

The Model Context Protocol (MCP) is an open standard that enables AI assistants to securely connect to external data sources and tools. For Advantage developers, this means your AI assistant can:

  • Access live documentation - Get real-time information from the latest docs
  • Search code examples - Find relevant implementation patterns instantly
  • Understand context - AI assistants gain deep knowledge about Advantage APIs and concepts
  • Stay synchronized - Always work with the most current information

Key Benefits ​

🔄 Always Up-to-Date ​

Unlike static documentation snapshots, the MCP server provides access to the live documentation directly from the repository. This means you'll never work with outdated information.

🎯 Contextual Assistance ​

Your AI assistant understands the full context of Advantage, including:

  • Format specifications (Topscroll, Midscroll, Welcome Page, etc.)
  • Messaging protocol details
  • Integration patterns
  • Best practices and examples

🚀 Faster Development ​

Get instant answers to questions like:

  • "How do I implement a custom format integration?"
  • "What are the available configuration options for the wrapper?"
  • "Show me an example of the messaging protocol in action"

The MCP server enables semantic search across the entire Advantage ecosystem, helping you find relevant information even when you don't know the exact terms.

Setting Up the MCP Server ​

Prerequisites ​

  • VS Code with GitHub Copilot or compatible AI assistant
  • Access to MCP-compatible development environment

Configuration ​

Add the Advantage MCP server to your settings:

json
To add this MCP to VSCode, update your .vscode/mcp.json

{
  "servers": {
    "advantage Docs": {
      "type": "sse",
      "url": "https://gitmcp.io/get-advantage/advantage"
    }
  }
}
json
To add this MCP to Cursor, update your ~/.cursor/mcp.json

{
  "mcpServers": {
    "advantage Docs": {
      "url": "https://gitmcp.io/get-advantage/advantage"
    }
  }
}
json
To add this MCP to Claude Desktop, update your claude_desktop_config.json

{
    "mcpServers": {
        "advantage Docs": {
            "type": "sse",
            "url": "https://gitmcp.io/get-advantage/advantage"
        }
    }
}

Available Capabilities ​

Once configured, the MCP server provides:

📚 Documentation Access ​

  • Complete access to all Advantage documentation
  • Format specifications and examples
  • Tutorial content for publishers and creatives
  • API reference materials
  • Search through the Advantage codebase
  • Find implementation examples
  • Discover usage patterns
  • Access test cases and samples

💡 Intelligent Assistance ​

  • Get contextual help based on your current work
  • Receive suggestions for best practices
  • Find relevant examples for specific use cases

Use Cases ​

For Publishers ​

"How do I configure the Advantage wrapper to exclude certain formats on mobile?"

The MCP server will provide current configuration options and examples from the documentation.

For Creatives ​

"Show me how to implement a custom format that requests TOPSCROLL"

Access to real code examples and the latest messaging protocol specifications.

For Integrators ​

"What are the available UI layer customization options?"

Get comprehensive information about styling and theming capabilities.

Best Practices ​

🎯 Be Specific ​

When asking questions, include context about what you're trying to achieve. The MCP server can provide more targeted assistance.

📖 Reference Documentation Types ​

Specify if you need:

  • Tutorial information
  • API reference details
  • Code examples
  • Conceptual explanations

🔄 Stay Current ​

The MCP server always provides the latest information, but make sure your local Advantage installation is also up-to-date.

Troubleshooting ​

Connection Issues ​

If the MCP server isn't responding:

  1. Check your internet connection
  2. Verify the server URL in your configuration
  3. Restart your development environment

Outdated Responses ​

The MCP server provides real-time access, but if you suspect information is outdated:

  1. Check the official documentation at get-advantage.org
  2. Verify your MCP server configuration
  3. Report issues in the GitHub repository

Development Workflow Integration ​

The MCP server integrates seamlessly into your development workflow:

  1. Planning Phase - Get architectural guidance and best practices
  2. Implementation - Access real-time API references and examples
  3. Testing - Find test patterns and validation approaches
  4. Documentation - Understand integration requirements and options

Community and Support ​

🚀 Ready to enhance your Advantage development experience? Configure the MCP server and start building with AI-powered assistance today!