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.