NotifyRelay /notify

What it does

Sends a Telegram message to a known chat ID. Supports Markdown formatting. Use for agent-to-human notifications where Telegram is the preferred channel. Cheaper than email — use this for frequent status updates, use email for formal delivery.

When to use it

• Status updates during a multi-step agent workflow
• Alerts when a monitored condition triggers
• Delivering structured summaries to a human operator

Request schema

{
  "chat_id": "123456789",
  "message": "✅ Task complete. 14 items processed."
}

Response schema

{
  "delivered": true
}

Code example — TypeScript via MCP

Install the MCP server once; all 16 services become tool calls.

// Configure @melis-ai/x402-tools-mcp in your MCP client
// Then call the tool:

const result = await mcpClient.callTool("notifyrelay_telegram", {
  "chat_id": "123456789",
  "message": "✅ Task complete. 14 items processed."
});

console.log(result);
// ["delivered"]...

Code example — Python via direct HTTP

import requests

# x402 payment header must be set by your wallet client
# See x402.org for client libraries

headers = {
    "Content-Type": "application/json",
    "x-payment": "<signed-x402-payment-header>",
}

resp = requests.post(
    "https://notify.melis.ai/notify",
    json={
      "chat_id": "123456789",
      "message": "✅ Task complete. 14 items processed."
    },
    headers=headers,
)
print(resp.json())

Code example — curl with internal key bypass

For testing with an issued internal key (skips x402 payment flow):

curl -X POST https://notify.melis.ai/notify \
  -H "Content-Type: application/json" \
  -H "x-internal-key: YOUR_KEY" \
  -d '{"chat_id":"123456789","message":"✅ Task complete. 14 items processed."}'

Related services

FAQ