Foundry MCP Server

How to use

To work with the Foundry MCP Server, you connect an MCP client that speaks the MCP protocol. You will discover and invoke tools across Models, Knowledge, Evaluation, and Finetuning to perform common tasks such as listing models, deploying a model to Azure AI Services, indexing data, running evaluations, or querying agents. The server acts as a centralized broker that handles authentication, authorization, and tool orchestration, so you can focus on building your workflows without managing individual service calls.

How to install

Prerequisites you need on your machine: a compatible runtime for MCP clients and a local environment ready for running MCP commands. You will also set up a workspace with an MCP configuration file that points to the server path.

Additional setup and configuration

Manual setup instructions are provided for running the MCP client locally in a development environment. You will create a workspace, optionally use a .env file to manage sensitive values, and configure the MCP client to start the Foundry MCP Server runner via a standard MCP JSON configuration.

{
  "servers": {
    "mcp_foundry_server": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--prerelease=allow",
        "--from",
        "git+https://github.com/azure-ai-foundry/mcp-foundry.git",
        "run-azure-ai-foundry-mcp",
        "--envFile",
        "${workspaceFolder}/.env"
      ]
    }
  }
}

list_models_from_model_catalog

Retrieves a list of supported models from the Azure AI Foundry catalog.

list_azure_ai_foundry_labs_projects

Retrieves a list of state-of-the-art AI models from Microsoft Research available in Azure AI Foundry Labs.

get_model_details_and_code_samples

Retrieves detailed information for a specific model from the Azure AI Foundry catalog.

get_prototyping_instructions_for_github_and_labs

Provides comprehensive instructions and setup guidance for starting to work with models from Azure AI Foundry and Azure AI Foundry Labs.

get_model_quotas

Get model quotas for a specific Azure location.

create_azure_ai_services_account

Creates an Azure AI Services account.

list_deployments_from_azure_ai_services

Retrieves a list of deployments from Azure AI Services.

deploy_model_on_ai_services

Deploys a model on Azure AI Services.

create_foundry_project

Creates a new Azure AI Foundry project.

list_index_names

Retrieve all names of indexes from the AI Search Service

list_index_schemas

Retrieve all index schemas from the AI Search Service

retrieve_index_schema

Retrieve the schema for a specific index from the AI Search Service

create_index

Creates a new index

modify_index

Modifies the index definition of an existing index

delete_index

Removes an existing index

add_document

Adds a document to the index

delete_document

Removes a document from the index

query_index

Searches a specific index to retrieve matching documents

get_document_count

Returns the total number of documents in the index

list_indexers

Retrieve all names of indexers from the AI Search Service

get_indexer

Retrieve the full definition of a specific indexer from the AI Search Service

create_indexer

Create a new indexer in the Search Service with the skill, index and data source

delete_indexer

Delete an indexer from the AI Search Service by name

list_data_sources

Retrieve all names of data sources from the AI Search Service

get_data_source

Retrieve the full definition of a specific data source

list_skill_sets

Retrieve all names of skill sets from the AI Search Service

get_skill_set

Retrieve the full definition of a specific skill set

fk_fetch_local_file_contents

Retrieves the contents of a local file path (sample JSON, document etc)

fk_fetch_url_contents

Retrieves the contents of a URL (sample JSON, document etc)

list_text_evaluators

List all available text evaluators.

list_agent_evaluators

List all available agent evaluators.

get_text_evaluator_requirements

Show input requirements for each text evaluator.

get_agent_evaluator_requirements

Show input requirements for each agent evaluator.

run_text_eval

Run one or multiple text evaluators on a JSONL file or content.

format_evaluation_report

Convert evaluation output into a readable Markdown report.

agent_query_and_evaluate

Query an agent and evaluate its response using selected evaluators. End-to-End agent evaluation.

run_agent_eval

Evaluate a single agent interaction with specific data (query, response, tool calls, definitions).

list_agents

List all Azure AI Agents available in the configured project.

connect_agent

Send a query to a specified agent.

query_default_agent

Query the default agent defined in environment variables.

fetch_finetuning_status

Retrieves detailed status and metadata for a specific fine-tuning job, including job state, model, creation and finish times, hyperparameters, and any errors.

list_finetuning_jobs

Lists all fine-tuning jobs in the resource, returning job IDs and their current statuses for easy tracking and management.

get_finetuning_job_events

Retrieves a chronological list of all events for a specific fine-tuning job, including timestamps and detailed messages for each training step, evaluation, and completion.

get_finetuning_metrics

Retrieves training and evaluation metrics for a specific fine-tuning job, including loss curves, accuracy, and other relevant performance indicators for monitoring and analysis.

list_finetuning_files

Lists all files available for fine-tuning in Azure OpenAI, including file IDs, names, purposes, and statuses.

execute_dynamic_swagger_action

Executes any tool dynamically generated from the Swagger specification, allowing flexible API calls for advanced scenarios.

list_dynamic_swagger_tools

Lists all dynamically registered tools from the Swagger specification, enabling discovery and automation of available API endpoints.