# `AshAi.Mcp`
[🔗](https://github.com/ash-project/ash_ai/blob/v0.6.1/lib/ash_ai/mcp.ex#L5)

Model Context Protocol (MCP) implementation for Ash Framework.

This module implements a [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server
that integrates with Ash Framework, following the MCP [Streamable HTTP Transport](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http) specification.

## Overview

This MCP implementation provides:

* A fully compliant MCP server with JSON-RPC message processing
* Session management with unique session IDs
* Support for both JSON and Server-Sent Events (SSE) responses
* Batch request handling
* A foundation for integrating Ash resources with MCP clients
* Integration with AshAi tools for AI-assisted operations

## Current Features

* `initialize` and `shutdown` method handlers
* Session management via GenServer processes
* Support for streaming responses
* Plug-compatible router for easy integration
* Tool support for AshAi functions

## Future Enhancements

* OAuth integration with AshAuthentication
* Resource-specific method handlers
* Advanced streaming capabilities

## Integration

### With Phoenix

```elixir
# In your Phoenix router
forward "/mcp", AshAi.Mcp.Router

# With tools enabled
forward "/mcp", AshAi.Mcp.Router, tools: [:tool1, :tool2]
```

### With Any Plug-Based Application

The MCP router is a standard Plug, so it can be integrated into any Plug-based application.
You are responsible for hosting the Plug however you prefer.

---

*Consult [api-reference.md](api-reference.md) for complete listing*