netlify-mcp-servers

Build and deploy authenticated MCP servers as Netlify Functions using the MCP SDK.

1|Updated May 13, 2026
One-click install
npx skills add https://github.com/SyedArmanAli2003/AgroNaV --skill netlify-mcp-servers-syedarmanali2003
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: netlify-mcp-servers
Source: https://github.com/SyedArmanAli2003/AgroNaV/tree/main/.agents/skills/netlify-mcp-servers
Command: npx skills add https://github.com/SyedArmanAli2003/AgroNaV --skill netlify-mcp-servers-syedarmanali2003

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @modelcontextprotocol/sdk, zod, and includes references (resource) components.

What problem does it solve? Exposing an app or API to AI agents like Claude, Cursor, or Claude Code requires a working Model Context Protocol server, but setting up the transport, authentication, and deployment correctly is error-prone. This Skill provides a verified pattern for running a stateless MCP server as a single Netlify Function over Streamable HTTP. ## Core Features & Use Cases - Server scaffolding: Create a deployable MCP endpoint in netlify/functions/mcp.ts using the official MCP SDK with the Web-standard Streamable HTTP transport, no Node adapter needed. - Authentication patterns: Implement a single shared bearer secret for personal servers or per-user API keys backed by Netlify Identity, with hashed key storage and revocation. - Safety and uploads: Apply least-privilege tool design, input validation with zod, and presigned-URL file uploads to Netlify Blobs via HMAC-signed tokens. - Use Case: You have an existing Netlify-hosted API and want Claude Code to query it as MCP tools. This Skill walks you through adding one function, securing it with a bearer token, and connecting the client with claude mcp add. ## Quick Start Ask the AI to create a Netlify MCP server function that exposes your API as tools, secured with a bearer token, and show how to connect Claude Code to it.

Frequently Asked Questions about netlify-mcp-servers

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build an MCP server on Netlify?▼

Create a Netlify Function that instantiates an McpServer from the official SDK and connects it to WebStandardStreamableHTTPServerTransport. Register tools with zod schemas, handle only POST requests, and expose the function at a path like /mcp.

How do I connect Claude Code to a remote MCP server?▼

Run claude mcp add --transport http with your server URL and an Authorization Bearer header. Claude Code supports native Streamable HTTP, so no mcp-remote bridge is needed for modern clients.

Should I use a shared secret or per-user API keys for MCP authentication?▼

Use a single shared secret stored as an env var for personal or single-user servers. Use per-user API keys backed by Netlify Identity when multiple people act as themselves, storing only SHA-256 hashes of keys with revocation support.

Why does my MCP server return HTTP 406 on POST requests?▼

A 406 means the client's Accept header is missing both application/json and text/event-stream, which the MCP spec requires. Fix the client's Accept header rather than changing the server.

Can an MCP tool accept file uploads from an agent?▼

Yes, but avoid base64 in tool arguments. Instead issue a short-lived HMAC-signed presigned URL, let the agent PUT raw bytes to it, store the file in Netlify Blobs, and reference it by a stable key in later tool calls.

Does Netlify Identity work with netlify dev for local testing?▼

No, Netlify Identity does not work under netlify dev. Per-user API key flows that depend on Identity must be tested on a deploy preview, while single-secret bearer auth works locally.