Dynamics Partner Advisor MCP

Overview

The Dynamics Partner Advisor is a Model Context Protocol (MCP) server that provides AI agents with powerful tools to help organizations find and compare Microsoft Dynamics 365 implementation partners. This server implements the standard MCP protocol using Server-Sent Events (SSE) transport, enabling intelligent partner selection based on product expertise, industry specialization, geographic coverage, and customer reviews.

Agents can use these tools to assist users in:

• Searching for partners by product, location, and industry
• Getting detailed information about specific partners
• Receiving personalized shortlist recommendations

Available Tools

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search_partners",
    "arguments": {
      "product": "business-central",
      "country": "US",
      "cityOrRegion": "California",
      "industry": "manufacturing",
      "min_review_score": 4.0,
      "max_results": 5
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_partner_details",
    "arguments": {
      "slug": "acme-dynamics-solutions"
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "recommend_shortlist",
    "arguments": {
      "company_size": "mid",
      "primary_product": "business-central",
      "industry": "manufacturing",
      "region": "US",
      "project_type": "new",
      "complexity_level": "moderate"
    }
  }
}

Manifest

The MCP manifest is available at:

Integration

This MCP server uses Server-Sent Events (SSE) transport. To integrate with your MCP client:

Connection Flow

1. Establish SSE Connection: Connect to GET https://topdynamicspartners.com/api/mcp/sse
   • Server returns a session ID in the X-Session-ID header
   • Connection remains open for bidirectional communication
2. Send Initialize Request: Send JSON-RPC initialize message via POST to /api/mcp/messages
   • Include x-session-id header with the session ID from step 1
   • Server responds via the SSE stream
3. Call Tools: Use JSON-RPC tools/call method to invoke tools
   • All tool calls use the same POST endpoint with session ID
   • Responses are delivered via the SSE stream

Example JSON-RPC Messages

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2024-11-05",
    "capabilities": {},
    "clientInfo": {
      "name": "my-client",
      "version": "1.0.0"
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/list"
}

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "search_partners",
    "arguments": {
      "product": "business-central",
      "country": "US",
      "max_results": 5
    }
  }
}

Using MCP Inspector

Test this server using the MCP Inspector:

Note: Legacy REST API endpoints are still available for backward compatibility:

• POST https://topdynamicspartners.com/api/mcp/search_partners
• POST https://topdynamicspartners.com/api/mcp/get_partner_details
• POST https://topdynamicspartners.com/api/mcp/recommend_shortlist

Getting Valid Parameter Values

To get the current list of valid values for products, industries, and services, use the reference data API:

Note: These endpoints return the current list of valid codes and names. You can use either the code or name field values in your API requests. The reference data may change over time, so it's recommended to fetch it periodically or cache it appropriately.

Response Format

The MCP server uses JSON-RPC 2.0 protocol. All responses are sent via the SSE stream in the following format:

{
  "jsonrpc": "2.0",
  "id": 3,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"partners\": [...]}"
      }
    ]
  }
}

{
  "jsonrpc": "2.0",
  "id": 3,
  "error": {
    "code": -32603,
    "message": "Internal error",
    "data": "Product \"invalid\" not found"
  }
}

Note: Tool results are returned as JSON strings within the content array. Parse the text field to access the actual data.

Testing

You can test the MCP server using our interactive test page. The test page allows you to try all three tools and see the JSON-RPC requests and responses in real-time.