fo-semantic-mcp

What is fo-semantic-mcp?

fo-semantic-mcp (Artifact MCP Server) connects your AI coding assistant (Claude Desktop, Cursor IDE, or VS Code) directly to the comprehensive xplusplus.ai artifact index — 50,000+ Finance and Operations artifacts with AI-powered semantic search.

Built on the Model Context Protocol (MCP), it enables your AI to automatically access out-of-box F&O code when you're developing X++ extensions or customizations. Your AI IDE (like Cursor) will intelligently retrieve original objects, learn from existing implementations, and understand how to properly extend F&O functionality — all without you having to manually search for examples.

This creates true AI pair programming: as you code, your AI assistant automatically references the right artifacts, suggesting best practices and patterns based on actual F&O source code.

⚠️ Important: This is a developer tool for accessing F&O source code, metadata, and artifacts (classes, tables, forms, etc.). It is not designed for accessing F&O business data or database records. Use this MCP server to understand code structure, learn implementation patterns, and develop extensions — not to query customer orders, inventory data, or other business information.

Key Features

Getting Started

1. Get Your API Key

   Sign in to xplusplus.ai and generate your API key from the dashboard.

2. Add Configuration to Your IDE

   Add the MCP server configuration - npx will automatically download and run it:

   Published on the official MCP registry.

3. Configure Your IDE

   Add the MCP server to your IDE configuration file:

   Cursor IDE:

   Edit ~/.cursor/mcp.json

   { "mcpServers": { "fo-semantic-mcp": { "command": "npx", "args": ["-y", "fo-semantic-mcp"], "env": { "FOINDEX_API_KEY": "your_api_key_here", "FO_LOCAL_ASSETS_PATH": "C:\\Users\\YourName\\AppData\\Local\\Microsoft\\Dynamics365\\10.0.xxxx\\PackagesLocalDirectory" } } } }

   Tip: Add FO_LOCAL_ASSETS_PATH to enable reading actual F&O XML source files

   No installation needed! npx automatically downloads and runs the latest version.

   Other AI Tools Setup Guides

   Claude Code

   CLI & VS Code Extension

   Setup Guide →

   Claude Desktop

   Standalone Desktop App

   Setup Guide →

   OpenAI Codex CLI

   Terminal Agent

   Setup Guide →

   Google Antigravity

   Agentic VS Code IDE

   Setup Guide →

   Microsoft Copilot Studio

   Low-Code AI Agent Builder

   Setup Guide →
4. Restart Your IDE

   Restart Cursor IDE or Claude Desktop. npx will automatically download the MCP server on first run (takes a few seconds), then it's cached for instant startup.

5. Start Coding with AI

   Your AI assistant can now automatically access F&O artifacts, find patterns, and suggest implementations using natural language.

Configuration Options

How It Works in Practice

🎯 Automatic AI Pair Programming (Most Important)

When you're writing X++ code for extensions or customizations, your AI IDE automatically calls the MCP server to retrieve out-of-box F&O objects. You don't need to manually search — your AI assistant proactively:

• Fetches the original class/table/form you're extending
• Analyzes existing patterns and methods
• Suggests proper extension approaches based on actual F&O code
• References related artifacts and dependencies automatically

Example: When extending SalesTable, Cursor IDE automatically retrieves the SalesTable class definition, studies its methods, and suggests how to properly implement your extension.

📝 Manual Queries

You can also explicitly ask your AI assistant questions like:

The MCP server translates these queries into precise artifact searches and delivers the results directly to your AI coding assistant.

Frequently Asked Questions

Do I need to install anything?

No! Just add the configuration to your IDE and restart. npx automatically downloads and runs the latest version. No npm install commands needed.

What is npx?

npx comes with Node.js and automatically downloads/runs npm packages. When you add the configuration, npx handles everything - download, caching, and execution.

Is this the official version?

Yes, fo-semantic-mcp is published on the official MCP registry and npm.

Does it work across all my D365 F&O projects?

Yes! Once configured in your IDE, it works for all your projects automatically. npx caches the package for fast subsequent runs.

How do I update to the latest version?

npx automatically uses the latest version. To force a fresh download, clear the npx cache: npm cache clean --force

What if I can't use npx?

For advanced users in restricted environments, you can install globally with npm install -g fo-semantic-mcp, or download ZIP archives from our GitHub Releases page. However, we recommend npx for the best experience.