NLWeb & MCP Testing Interface

This page allows you to test the new NLWeb (/ask) and MCP (/mcp) endpoints. These Netlify Function-based endpoints provide enhanced ways for AI assistants and other tools to interact with site content.

Refer to the NLWeb/MCP Documentation for detailed API specifications.

Note: Legacy endpoints (/api/mcp, /api/mcp-debug, /api/mcp-static) are deprecated and have been removed from this testing page.

Test /ask Endpoint (NLWeb)

/ask Response:
Results will appear here...

Test /mcp Endpoint (JSON-RPC)

NLWeb Query via /mcp

This sends a standard NLWeb query, wrapped in a JSON-RPC request, to the /mcp endpoint. Streaming is not applicable here as /mcp always returns full JSON responses.

/mcp NLWeb Passthrough Response:
Results will appear here...

Quick Integration Notes

When connecting an AI assistant (like Claude via its MCP client support) or building other integrations:

  1. For MCP clients (like Claude): Use the /mcp endpoint URL: https://www.janisheck.com/mcp. This provides access to MCP methods like tools/list, tools/call (for "searchBlog"), and also NLWeb queries via JSON-RPC passthrough.
  2. For direct NLWeb queries (e.g., custom applications, conversational AI that doesn't need full MCP): Use the /ask endpoint. This supports JSON requests and Server-Sent Events (SSE) for streaming.
  3. Refer to the example requests on this page and the parameters described in the main documentation.

For comprehensive details, visit the NLWeb & MCP Documentation page.