Skip to main content

Documentation Index

Fetch the complete documentation index at: https://redop.useagents.site/docs/llms.txt

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

When an HTTP client cannot connect, debug the transport before you debug your tools.

​
Turn on transport logs

app.listen({
  port: Number(process.env.PORT ?? 3000),
  hostname: "0.0.0.0",
  cors: true,
  debug: true,
});
That prints request, session, initialize, and response logs from the HTTP transport.

​
Check the endpoint first

The MCP URL is: 
http://localhost:3000/mcp
Do not point clients at /mcp/health or /mcp/schema. The current transport does not mount those routes by default. If you enabled health, use that custom path for platform checks only, not as the MCP client endpoint.

​
What the current transport serves

  • POST /mcp for JSON-RPC
  • GET /mcp for the event stream
  • DELETE /mcp for session termination
  • an optional health route when you enable health

​
Practical compatibility notes

  • the transport negotiates MCP protocol versions with the client
  • it keeps a compatibility layer for local Inspector-style workflows
  • it accepts client-provided session IDs for better tooling interoperability

​
Common checks

  • make sure the client uses the /mcp path
  • keep one simple tool like ping until the handshake succeeds
  • if you are using stdio, send logs to stderr, not stdout