1# MCP (Model Context Protocol) Recipe
2 
3MCP tool endpoints for AI agent integration via the JSON-RPC 2.0 protocol.
4 
5## Template Selection
6 
7Resource filter: `mcp`  
8Discover templates via MCP or CDN manifest where `resource == "mcp"` and `language` matches user request.
9 
10## Protocol
11 
12MCP uses the **JSON-RPC 2.0** protocol. Two template types with different transport support:
13 
14- **Extension-based** (`mcp-server-remote-*`) supports both Streamable HTTP and SSE transports
15- **Self-hosted** (`mcp-sdk-hosting-*`) — supports Streamable HTTP only
16 
17See [MCP Specification](https://modelcontextprotocol.io/) for protocol details.
18 
19## Troubleshooting
20 
21### Transport Mismatch
22 
23**Cause:** Client and server using different transports — SSE client gets `404`/`405`, HTTP client gets unexpected `text/event-stream`.  
24**Solution:** Extension-based templates support both Streamable HTTP and SSE. Self-hosted templates support Streamable HTTP only. In VS Code `mcp.json`, set `"type": "sse"` or `"type": "http"` to match the server.
25 
26### Missing App Settings After Deploy
27 
28**Cause:** Required app settings not configured on the function app.  
29**Solution:** Ensure protected resource metadata settings are present. For C# self-hosted servers, verify `host.json` `arguments` points to the compiled DLL path.
30 
31See [MCP extension trigger and bindings](https://learn.microsoft.com/azure/azure-functions/functions-bindings-mcp) for extension-based servers, [Self-hosted MCP servers](https://learn.microsoft.com/en-us/azure/azure-functions/self-hosted-mcp-servers) for self-hosted architecture, and [MCP tutorial troubleshooting](https://learn.microsoft.com/en-us/azure/azure-functions/functions-mcp-tutorial?tabs=self-hosted#troubleshooting) for self-hosted deployment issues.
32 
33## Eval
34 
35| Path | Description |
36|------|-------------|
37| [eval/summary.md](eval/summary.md) | Evaluation summary |
38| [eval/python.md](eval/python.md) | Python evaluation results |
39