Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.waniwani.ai/llms.txt

Use this file to discover all available pages before exploring further.

MCP clients like ChatGPT and Claude need a public URL to reach your server. A tunnel forwards traffic from a public URL to your local dev server — no deployment required.
If you started from the MCP Distribution Template, bun dev already spawns a Cloudflare tunnel and prints the public URL. You don’t need this guide. Continue only if you’re running a custom dev server.

​
1. Start your dev server

bun run dev
# or: npm run dev, node dist/index.js, etc.
Note the port your server is listening on (usually 3000, 8080, or 8787). Check your server logs or package.json for the exact port.

​
2. Start a tunnel

​
3. Use the tunnel URL

Replace localhost with the tunnel URL in your MCP client config: 
{
  "mcpServers": {
    "my-server": {
      "url": "https://<tunnel-url>/mcp"
    }
  }
}
Both the dev server and the tunnel must stay running. If either stops, the public URL stops working.

​
Using the agent skill

If you have the WaniWani SDK agent skill installed, you can run the /waniwani-sdk tunnel command and your AI agent will handle the entire setup for you — detecting the dev server port, picking an available tunnel provider, and printing the public URL. See Commands for details.

​
Good to know

  • Quick tunnels generate a new URL each time. For a stable URL, set up a named Cloudflare tunnel or use an ngrok paid plan.
  • stdio transport does not need a tunnel. Tunnels are only needed for HTTP-based transports (Streamable HTTP, SSE).
  • ngrok free tier has rate limits and session expiry (typically 2 hours).