Developers

This section is for developers building against Willow rather than configuring it in the dashboard. It covers authenticating to the gateway programmatically, calling MCP tools over HTTP, and building internal MCP servers that Willow proxies to.

Tutorials

Start here to build something end to end:

• Make your first gateway call — create a machine user and make an authenticated MCP tool call from a script with curl.
• Build an OAuth MCP server with Express — a complete, runnable Node.js server for Proxy OAuth, connected in Willow end to end.
• Build an API-key MCP server with Express — a complete, runnable Node.js server for Proxy API Key.

Reference

• Programmatic gateway access — the /mcp endpoint, machine-user auth, the MCP handshake, and tool namespacing.
• Build an MCP server behind Willow — how Willow forwards auth per server auth mode, and how to validate the token you receive.
• Build an OAuth-protected MCP server — the discovery, registration, authorization, and token endpoints Willow's Proxy OAuth mode expects.
• Accept per-user API keys — receive and validate the key Willow forwards in Proxy API Key mode.
• How identities authenticate — how human and machine identities differ at the front door and downstream.
• OAuth Authorization Server — the gateway's OAuth resource metadata and token endpoint.
• SCIM API — user and group provisioning endpoints.