Skip to main content

Dynamics Partner Advisor MCP

The Model Context Protocol server for AI-powered Microsoft Dynamics 365 partner discovery. Available in free and authenticated tiers.

Access Tiers

Start free, upgrade for unlimited access

Free Tier

No API key required

search_partners

Up to 3 results with core fields only (name, location, products)

get_partner_details

Returns 401 – upgrade to unlock

recommend_shortlist

1 result, name + URL only

Requests per minute30
Requests per day250

Authenticated Tier

Include x-api-key header

Recommended

search_partners

Up to 25 results with all fields (detailed metrics, reviews)

get_partner_details

Full partner profile with all metrics and services

recommend_shortlist

Up to 5 results with fit reasons and risk assessment

Requests per minute60
Requests per day100,000

What This Is

Freemium API for partner discovery

For AI Agents

Use the Model Context Protocol to help users find the perfect Dynamics 365 implementation partner via Claude, custom clients, or any MCP-compatible tool.

Standard Protocol

Fully compliant JSON-RPC 2.0 over SSE transport. Compatible with Claude Desktop, MCP Inspector, and custom implementations.

Real Partner Data

Access our curated database of Microsoft Dynamics partners with product expertise, industry specialization, and verified reviews.

Available Tools

Three tools to power partner discovery

search_partners

Find partners by product, location, industry, and review score

Free & Authenticated

Parameters

  • product * - Product code or name
  • country * - ISO country code or name
  • cityOrRegion - City name or state code
  • industry - Industry code or name
  • min_review_score - Minimum rating (0.0-5.0)
  • max_results - Limit results (Free: 3, Auth: 25)

Tier Differences

Free

3 results, core fields only (name, location, products)

Authenticated

25 results, all fields (metrics, reviews, services)

Example JSON-RPC Call:

{
  "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
    }
  }
}

get_partner_details

Get full details about a specific partner

Authenticated Only

Parameters

  • slug * - Partner slug or business name

Use kebab-case or business name directly. Partial matching supported.

Response

Full Partner Profile

  • • Products and expertise
  • • Industries served
  • • Services offered
  • • Reviews
  • • And more

Example JSON-RPC Call:

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

recommend_shortlist

Get personalized partner recommendations

Free & Authenticated

Parameters

  • company_size * - small | mid | enterprise
  • primary_product * - Product code or name
  • industry * - Industry code or name
  • region * - Country code or name
  • project_type * - new | upgrade | rescue | extension
  • complexity_level * - simple | moderate | complex
  • budget - Budget range (e.g. "50k-100k", "100k-500k", "500k+")

Tier Differences

Free

1 result, name and URL only

Authenticated

5 results with fit reasons and risk notes

Example JSON-RPC Call:

{
  "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",
      "budget": "100k-500k"
    }
  }
}

Authentication

Getting and using your API key

Free Tier (No API Key)

Make requests without authentication. You'll get limited data with tier-specific result counts.

Authenticated Tier (Requires API Key)

Include your API key in the request header:

x-api-key: your-api-key-here

Where to Get Your API Key

API keys are available through your TDP account. Contact us to upgrade from free to authenticated tier access.

Request API Access →

Rate Limits

Fair usage limits per tier

Free Tier

Per minute30 reqs
Per day250 reqs

Authenticated Tier

Per minute60 reqs
Per day100,000 reqs

Integration

Connect via MCP or REST

Model Context Protocol (MCP)

This is a fully compliant MCP server using JSON-RPC 2.0 over SSE transport.

Endpoints

SSE Connection: GET /api/mcp/sse

Messages: POST /api/mcp/messages

Quick Start

  1. Connect to GET /api/mcp/sse
  2. Save the X-Session-ID from response headers
  3. Send JSON-RPC requests to POST /api/mcp/messages with your session ID
  4. Receive responses via the SSE stream

Legacy REST API

For backward compatibility, these REST endpoints are also available:

POST /api/mcp/search_partners

POST /api/mcp/get_partner_details

POST /api/mcp/recommend_shortlist

Test It Out

Try all three tools with our interactive test page. Edit parameters, see responses, and copy curl commands.

Reference Data

Get valid product, industry, and service codes

Get Products

GET https://topdynamicspartners.com/api/listings/metadata/reference?type=products

Returns array of product codes and names (business-central, dynamics-365-sales, etc.)

Get Industries

GET https://topdynamicspartners.com/api/listings/metadata/reference?type=industries

Returns array of industry codes and names (manufacturing, retail, professional-services, etc.)

Get Services

GET https://topdynamicspartners.com/api/listings/metadata/reference?type=services

Returns array of service codes and names (erp-implementation, data-migration, consulting, etc.)

Tip: You can use either the code or name field in API requests. Reference data may change — cache appropriately.

Ready to Get Started?

Use the interactive test page to explore all three tools, try different parameters, and understand the tier differences in action.