#MCP tools: ask and guide

Heplon exposes an MCP endpoint at /mcp over Streamable HTTP. The endpoint hosts a suite of tools. Today that suite is ask and guide.

#Endpoint

A request without a valid access token is rejected before any MCP handling runs. This applies to every tool the endpoint hosts.

#Tool: ask

Answers a natural-language question about your platform.

#Tool: guide

Briefs a coding agent on the platform context for a piece of work it is about to do.

#Example: call ask

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": { "name": "ask", "arguments": { "question": "what runs billing?" } }
}

The result content is the agent's textual answer.

#Example: call guide

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "guide",
    "arguments": { "intent": "write a Rust service that reads from the orders datastore" }
  }
}

The result content is a markdown briefing.

#See also

• What Heplon gives your coding agent: why these tools exist and what they unlock.
• The platform graph.
• Authoritative behaviour: mcp-endpoint and platform-advisor.