{"name":"io.github.gege-mn/ray-mcp","slug":"gege-mn-ray-mcp","title":"Ray notifications","description":"Send email, push, Slack, Discord, Telegram and webhook notifications and manage templates with Ray.","url":"https://mcp.market/server/gege-mn-ray-mcp","rating":null,"grade":"A","score":90,"certified":false,"status":"active","category":"email","tags":["email","productivity"],"presence":{"score":34,"stars":0,"forks":0,"downloads_week":149,"last_push_at":"2026-09-19T13:04:35.000Z","license":"MIT"},"uptime":{"percent":100,"checks":1,"ok":1,"last_checked_at":"2026-09-19T17:35:48.161Z","last_ok_at":"2026-09-19T17:35:48.161Z","latency_ms":490},"claimed":false,"transport":"mixed","callable_via_gateway":true,"default_price_micros":0,"repository":"https://github.com/gege-mn/ray-mcp","website":"https://ray.gege.mn/docs","version":"0.1.0","remotes":[{"type":"streamable-http","url":"https://ray-api.gege.mn/mcp","headers":[{"description":"Bearer token with your Ray API key, created at https://ray.gege.mn under API keys.","isRequired":true,"value":"Bearer {ray_api_key}","isSecret":true,"variables":{"ray_api_key":{"description":"Ray API key (ck_live_...)","isRequired":true,"isSecret":true,"placeholder":"ck_live_..."}},"name":"Authorization"}]}],"packages":[{"registryType":"npm","registryBaseUrl":"https://registry.npmjs.org","identifier":"@gege-mn/ray-mcp","version":"0.1.0","runtimeHint":"npx","transport":{"type":"stdio"},"environmentVariables":[{"description":"Ray API key (ck_live_...). Create one at https://ray.gege.mn under API keys; use the write scope to send and edit.","isRequired":true,"isSecret":true,"placeholder":"ck_live_...","name":"RAY_API_KEY"},{"description":"Hosted Ray MCP endpoint to bridge to. Only change this for self-hosted or staging deployments.","format":"string","default":"https://ray-api.gege.mn/mcp","name":"RAY_MCP_URL"}]}],"tools":[{"name":"archive_template","description":"Archive a template (POST /templates/{id}/archive; write scope). Sends that reference it fail until it is restored with unarchive_template; its name stays reserved meanwhile. Confirm with the user first if it may be in production use.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"templateId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"The template id (UUID)."}},"required":["templateId"],"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"create_template","description":"Create a template (POST /templates; write scope). `channelKind` is permanent and must match the channels you'll send through (list_channels `templateKind`). It is saved as an unpublished draft unless `publish: true`; sending by templateId needs a published version (publish_template). Names are unique per workspace including archived templates: a collision returns 409, so unarchive_template the old one instead. Returns `{ id, requiredParams }`. Designed (drag-and-drop) email templates can only be made in the dashboard.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100,"description":"Template name, unique per workspace (archived templates included)."},"folder":{"description":"Optional folder path for organisation, e.g. \"billing\".","type":"string","maxLength":200},"channelKind":{"type":"string","enum":["email_html","fcm_basic","slack_text","discord_text","telegram_text","sms_text","webhook_json"],"description":"Which channel family the template renders for. Must match the `templateKind` of the channels you will send through (list_channels). Can't be changed after creation."},"content":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"Channel-shaped template body; the shape is fixed by `channelKind`: email_html → `{ subject, bodyHtml, bodyText }`; fcm_basic → `{ title, body, imageUrl?, data?: { [key]: string } }`; slack_text → `{ text }`; discord_text → `{ content }` (max 2000 chars); telegram_text → `{ text, disableLinkPreview? }`; sms_text → `{ text }` (plain text, max 1600; long text is split into several billed SMS — on sendsms_mn into parts of 159 plain-Latin / 69 Cyrillic chars); webhook_json → `{ title, body, data?: { [key]: string } }`. Use `{{name}}` placeholders and `{{#items}}…{{/items}}` sections; the required params are derived from them automatically."},"logTitle":{"type":"string","minLength":1,"maxLength":500,"description":"Short title shown in the in-app feed and delivery logs, e.g. \"Invoice {{number}} is due\". Placeholders allowed."},"logDescription":{"type":"string","minLength":1,"maxLength":2000,"description":"One-line description for the in-app feed and delivery logs. Placeholders allowed."},"paramOverrides":{"description":"Per-param metadata keyed by param name: `{ optional?: boolean, description?: string }`. Mark a placeholder optional so sends may omit it.","type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","properties":{"optional":{"type":"boolean"},"description":{"type":"string","maxLength":500}}}},"publish":{"description":"true = publish this version immediately so sends by templateId use it. Default false (saved as draft).","type":"boolean"}},"required":["name","channelKind","content","logTitle","logDescription"],"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"create_webhook","description":"Create an outbound webhook that Ray POSTs signed event payloads to (POST /tenant-webhooks; write scope; Pro plan or higher, otherwise 403). The URL must be public HTTPS. The response contains the signing `secret` exactly once: show it to the user to store (e.g. as an env var), since it can't be read again, only rotated with update_webhook. Read the `webhooks` docs page for the signature scheme.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100,"description":"Label for the webhook, e.g. \"Production delivery events\"."},"url":{"type":"string","description":"Public HTTPS endpoint that will receive the events."},"events":{"minItems":1,"type":"array","items":{"type":"string","enum":["notification.delivered","notification.failed_terminal","send.completed"]},"description":"Events to receive: \"notification.delivered\", \"notification.failed_terminal\" (one per recipient), and \"send.completed\" (once per send, with status totals)."}},"required":["name","url","events"],"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"delete_webhook","description":"Delete (archive) a webhook so it receives no more events (DELETE /tenant-webhooks/{id}; write scope). It cannot be restored through the API; confirm with the user first.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"webhookId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"The webhook id (UUID)."}},"required":["webhookId"],"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"get_click_stats","description":"Email link click counts grouped by destination URL (GET /clicks) for a `sendId`, a `campaignId`, or both (at least one is required). Only links from email sends made with `trackClicks: true` are counted.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"sendId":{"description":"A sendId from send_notification.","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"campaignId":{"description":"The `campaignId` passed to send_notification, to total clicks across many sends.","type":"string","minLength":1,"maxLength":256}},"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"get_send_status","description":"Delivery status of a send (GET /sends/{id}): `aggregate` counts per status over the whole send (pending, claimed, delivered, failed_retryable, failed_terminal, suppressed) plus one page of per-recipient delivery rows including provider errors. Right after sending, rows are usually `pending`; check again after a few seconds. Feed-only sends have no rows. For more rows, pass the returned `nextCursor` as `cursor`.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"sendId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"The `sendId` returned by send_notification or test_send_template."},"cursor":{"description":"`nextCursor` from the previous page.","type":"string","minLength":1},"limit":{"description":"Rows per page (default 50, max 200).","type":"integer","minimum":1,"maximum":200}},"required":["sendId"],"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"get_template","description":"Get one template with its published version and its current draft (GET /templates/{id}): content, logTitle/logDescription, `requiredParams` a send must supply, and paramOverrides. Read this before update_template_draft, which needs the full body.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"templateId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"The template id (UUID)."}},"required":["templateId"],"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"get_usage","description":"The workspace's plan, subscription status and this calendar month's usage against the monthly quota (GET /billing/subscription). `used`/`remaining` are null on unmetered plans. On a hard-capped plan, sends beyond the quota fail with HTTP 402 quota_exceeded.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"get_webhook","description":"Get one outbound webhook (GET /tenant-webhooks/{id}) including its delivery health (consecutiveFailures, lastDeliveryAt, lastFailureAt, lastError).","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"webhookId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"The webhook id (UUID)."}},"required":["webhookId"],"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"list_channels","description":"List the delivery channels configured in this workspace (GET /channels). Call this FIRST before sending: each entry's `id` is the `channelConfigId` for send_notification and test_send_template, `kind` is the channel type (ses_email, smtp_email, fcm_push, slack_webhook, discord_webhook, telegram_bot, twilio_sms, sendsms_mn, generic_webhook), `templateKind` is the template channelKind it accepts, and `recipientSchema` is the exact JSON Schema of the `recipient` it expects. Channels and their provider credentials are set up in the Ray dashboard, not through this API; if the list is empty, ask the user to add one there.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"list_feed_notifications","description":"Read one end user's in-app notification feed (GET /notifications): the entries created by sends with `feed` or `showInFeed`. This is what an in-app inbox would show, not delivery status (use get_send_status for that). Paginate by passing `nextCursor` back as `cursor`.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"externalUserId":{"type":"string","minLength":1,"maxLength":256,"description":"The end user whose feed to read (the `externalUserId` used when sending)."},"templateId":{"description":"Only entries from this template.","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"channelConfigId":{"description":"Only entries whose first delivery used this channel.","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"after":{"description":"Only entries created after this ISO 8601 UTC datetime (e.g. \"2026-09-01T00:00:00Z\").","type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"before":{"description":"Only entries created before this ISO 8601 UTC datetime.","type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"cursor":{"description":"`nextCursor` from the previous page.","type":"string","minLength":1},"limit":{"description":"Entries per page (default 50, max 200).","type":"integer","minimum":1,"maximum":200}},"required":["externalUserId"],"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"list_templates","description":"List message templates (GET /templates): id, name, folder, channelKind, and `publishedVersionId` (null = never published, so it cannot be sent by templateId yet). Archived templates are hidden unless `includeArchived` is true. Use get_template for content and required params.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"folder":{"description":"Only templates in this folder.","type":"string","maxLength":200},"includeArchived":{"description":"Include archived templates. Default false.","type":"boolean"}},"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"list_webhooks","description":"List the workspace's outbound event webhooks (GET /tenant-webhooks): url, subscribed events, enabled flag and delivery health (consecutiveFailures, lastError). Signing secrets are never returned.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"includeArchived":{"description":"Include deleted (archived) webhooks. Default false.","type":"boolean"}},"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"publish_template","description":"Publish a template's current draft as its new live version (POST /templates/{id}/publish; write scope). Sends by templateId use it immediately. Fails if there is no draft or the template is archived.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"templateId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"The template id (UUID)."}},"required":["templateId"],"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"read_docs","description":"Read Ray's documentation as markdown. With no `slug` it returns the index (llms.txt) listing every page; then pass a page slug, i.e. the path after /docs/ without `.md`, such as `sending`, `templates`, `idempotency`, `errors`, `rate-limits`, `webhooks`, `status-and-feeds` or `channels/telegram`. Use it for anything the tool descriptions don't cover.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"slug":{"description":"Page slug like \"sending\" or \"channels/push-fcm\". Omit for the index of all pages.","type":"string","maxLength":100}},"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"send_notification","description":"Send a notification (POST /send; needs a `write`-scoped key). Returns `{ sendId }` with HTTP 202: delivery is asynchronous, so check the outcome with get_send_status. Use exactly one mode:\n1. Single: `channelConfigId` + `recipient`.\n2. Fan-out: `channelConfigId` + `targets` (1-1000 `{ recipient, externalUserId? }`), one channel, one sendId.\n3. Multi-channel: `deliveries` (1-10, each with its own `channelConfigId`, `recipient` and `templateId` or `content`) for ONE person over several channels; add `feed` + `externalUserId` for a single in-app feed entry.\n4. Feed-only: `feed` (with `title`) + `externalUserId` and no channel: an in-app notification only.\nIn modes 1-2 give exactly one of `templateId` (a published template, plus `params`) or inline `content`; in mode 3 that choice is made per delivery. Get channel ids and each recipient shape from list_channels first. Pass `idempotencyKey` whenever a retry must not deliver twice.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"channelConfigId":{"description":"Modes 1-2: the channel to send through — an `id` from list_channels. Not allowed together with `deliveries`.","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"recipient":{"description":"Mode 1: the single recipient. Mutually exclusive with `targets`. Channel-specific delivery target. Its shape depends on the kind of the chosen channel (list_channels returns each channel's exact `recipientSchema`): ses_email / smtp_email → `{ email, name?, cc?: [{ email, name? }], bcc?: [...], attachments?: [{ filename, content (base64), contentType?, disposition?: \"attachment\"|\"inline\", contentId? }] }`; fcm_push → `{ deviceToken }` OR `{ topic }` (exactly one; Ray keeps no device registry); telegram_bot → `{ chatId }` (numeric id as a string, or \"@channelname\"); twilio_sms → `{ phoneNumber }` (international E.164, e.g. \"+97699112233\"); sendsms_mn → `{ phoneNumber }` (Mongolian 8-digit, e.g. \"99112233\"); slack_webhook, discord_webhook, generic_webhook → `{}` (the destination is part of the channel config).","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"targets":{"description":"Mode 2: fan-out to 1-1000 recipients over ONE channel, sharing one sendId. Mutually exclusive with `recipient`.","minItems":1,"maxItems":1000,"type":"array","items":{"type":"object","properties":{"recipient":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"Channel-specific delivery target. Its shape depends on the kind of the chosen channel (list_channels returns each channel's exact `recipientSchema`): ses_email / smtp_email → `{ email, name?, cc?: [{ email, name? }], bcc?: [...], attachments?: [{ filename, content (base64), contentType?, disposition?: \"attachment\"|\"inline\", contentId? }] }`; fcm_push → `{ deviceToken }` OR `{ topic }` (exactly one; Ray keeps no device registry); telegram_bot → `{ chatId }` (numeric id as a string, or \"@channelname\"); twilio_sms → `{ phoneNumber }` (international E.164, e.g. \"+97699112233\"); sendsms_mn → `{ phoneNumber }` (Mongolian 8-digit, e.g. \"99112233\"); slack_webhook, discord_webhook, generic_webhook → `{}` (the destination is part of the channel config)."},"externalUserId":{"description":"Your own id for this recipient. With `feed`/`showInFeed` they also get an in-app feed entry.","type":"string","minLength":1,"maxLength":256}},"required":["recipient"]}},"deliveries":{"description":"Mode 3: the same notification to ONE person over several channels (e.g. push + email), max 10. Each entry has its own channel, recipient and content source. Do not combine with top-level channelConfigId/recipient/targets/templateId/content.","minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"channelConfigId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Channel for this delivery (from list_channels)."},"recipient":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"Channel-specific delivery target. Its shape depends on the kind of the chosen channel (list_channels returns each channel's exact `recipientSchema`): ses_email / smtp_email → `{ email, name?, cc?: [{ email, name? }], bcc?: [...], attachments?: [{ filename, content (base64), contentType?, disposition?: \"attachment\"|\"inline\", contentId? }] }`; fcm_push → `{ deviceToken }` OR `{ topic }` (exactly one; Ray keeps no device registry); telegram_bot → `{ chatId }` (numeric id as a string, or \"@channelname\"); twilio_sms → `{ phoneNumber }` (international E.164, e.g. \"+97699112233\"); sendsms_mn → `{ phoneNumber }` (Mongolian 8-digit, e.g. \"99112233\"); slack_webhook, discord_webhook, generic_webhook → `{}` (the destination is part of the channel config)."},"templateId":{"description":"Published template for this delivery. Exactly one of `templateId` or `content`.","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"content":{"description":"Inline message content, used INSTEAD of `templateId` (give exactly one of the two). Shape by channel kind: ses_email / smtp_email → `{ subject, bodyHtml, bodyText }`; fcm_push → `{ title, body, imageUrl?, data?: { [key]: string } }`; slack_webhook → `{ text }` (Slack mrkdwn); discord_webhook → `{ content }` (max 2000 chars); telegram_bot → `{ text, disableLinkPreview? }` (Telegram HTML subset); twilio_sms / sendsms_mn → `{ text }` (plain text; up to 1600 chars on Twilio, sendsms_mn splits long text into SMS of 159 plain-Latin / 69 Cyrillic chars, each billed); generic_webhook → `{ title, body, data?: { [key]: string } }`. `{{name}}` placeholders are filled from `params` and escaped for the channel.","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"params":{"description":"Params for this delivery; falls back to the top-level `params`.","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"logTitle":{"description":"Feed/log title; only valid with inline `content`.","type":"string","maxLength":500},"logDescription":{"description":"Feed/log description; only valid with inline `content`.","type":"string","maxLength":2000}},"required":["channelConfigId","recipient"]}},"templateId":{"description":"Modes 1-2: a PUBLISHED template to render (see list_templates / publish_template). Exactly one of `templateId` or `content`. Its channelKind must match the channel's `templateKind`.","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"content":{"description":"Inline message content, used INSTEAD of `templateId` (give exactly one of the two). Shape by channel kind: ses_email / smtp_email → `{ subject, bodyHtml, bodyText }`; fcm_push → `{ title, body, imageUrl?, data?: { [key]: string } }`; slack_webhook → `{ text }` (Slack mrkdwn); discord_webhook → `{ content }` (max 2000 chars); telegram_bot → `{ text, disableLinkPreview? }` (Telegram HTML subset); twilio_sms / sendsms_mn → `{ text }` (plain text; up to 1600 chars on Twilio, sendsms_mn splits long text into SMS of 159 plain-Latin / 69 Cyrillic chars, each billed); generic_webhook → `{ title, body, data?: { [key]: string } }`. `{{name}}` placeholders are filled from `params` and escaped for the channel.","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"params":{"description":"Values for the template's `{{placeholders}}`. Any JSON: strings, numbers, booleans, arrays and nested objects (arrays/objects drive `{{#section}}…{{/section}}` blocks). Missing required params are rejected with a 400 naming them.","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"logTitle":{"description":"Feed/log title for inline `content` sends only (template sends take it from the template). Placeholders allowed.","type":"string","maxLength":500},"logDescription":{"description":"Feed/log description for inline `content` sends only. Placeholders allowed.","type":"string","maxLength":2000},"feed":{"description":"Create exactly ONE in-app feed entry for `externalUserId` (read back with list_feed_notifications). `title`/`description` default to the rendered template text; `title` is required for a feed-only send (mode 4).","type":"object","properties":{"title":{"type":"string","maxLength":500},"description":{"type":"string","maxLength":2000}}},"externalUserId":{"description":"Your own id for the end user. Required with `feed`; keys their in-app feed.","type":"string","minLength":1,"maxLength":256},"showInFeed":{"description":"Legacy modes 1-2 flag: also add a feed entry for each target that has an externalUserId. Prefer `feed`. Not valid with `deliveries`.","type":"boolean"},"trackClicks":{"description":"Email channels only: rewrite links in bodyHtml so clicks are counted (read with get_click_stats). Default false.","type":"boolean"},"campaignId":{"description":"Free-form campaign id used to group click stats across sends.","type":"string","minLength":1,"maxLength":256},"notBefore":{"description":"Schedule delivery for later: ISO 8601 datetime with offset, e.g. \"2026-09-15T09:00:00+08:00\". Omit to send now.","type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"priority":{"description":"\"high\" (default) for transactional messages; \"low\" for marketing/bulk so it never delays transactional sends.","type":"string","enum":["high","low"]},"idempotencyKey":{"description":"Sent as the Idempotency-Key header. Retrying with the same key and same arguments returns the original sendId without sending again (24h window); the same key with different arguments fails with 409. Use a fresh unique value (e.g. a UUID) per logical notification.","type":"string","minLength":1,"maxLength":255}},"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"test_send_template","description":"Send a real test of a template's PUBLISHED version to one recipient (POST /templates/{id}/test-send; write scope). It goes through the provider for real, so use a recipient the user controls. Test sends don't count toward the monthly quota (a small daily allowance applies instead) and never appear in feeds. Returns `{ sendId }` for get_send_status.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"templateId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"The template id (UUID)."},"channelConfigId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Channel to test through (from list_channels); its templateKind must match the template's channelKind."},"recipient":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"Channel-specific delivery target. Its shape depends on the kind of the chosen channel (list_channels returns each channel's exact `recipientSchema`): ses_email / smtp_email → `{ email, name?, cc?: [{ email, name? }], bcc?: [...], attachments?: [{ filename, content (base64), contentType?, disposition?: \"attachment\"|\"inline\", contentId? }] }`; fcm_push → `{ deviceToken }` OR `{ topic }` (exactly one; Ray keeps no device registry); telegram_bot → `{ chatId }` (numeric id as a string, or \"@channelname\"); twilio_sms → `{ phoneNumber }` (international E.164, e.g. \"+97699112233\"); sendsms_mn → `{ phoneNumber }` (Mongolian 8-digit, e.g. \"99112233\"); slack_webhook, discord_webhook, generic_webhook → `{}` (the destination is part of the channel config)."},"params":{"description":"Values for the template's `{{placeholders}}`. Any JSON: strings, numbers, booleans, arrays and nested objects (arrays/objects drive `{{#section}}…{{/section}}` blocks). Missing required params are rejected with a 400 naming them.","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["templateId","channelConfigId","recipient"],"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"unarchive_template","description":"Restore an archived template (POST /templates/{id}/unarchive; write scope). This is how to reclaim a name held by an archived template instead of creating a new one.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"templateId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"The template id (UUID)."}},"required":["templateId"],"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"update_template_draft","description":"Replace a template's draft (PATCH /templates/{id}; write scope). This is a full replacement, not a partial patch: pass content, logTitle, logDescription and paramOverrides as they should end up (get_template first). `name`, `folder` and `channelKind` are required for validation but not changed (channelKind must equal the original). Live sends keep using the published version until you publish, either with `publish: true` here or publish_template. Fails on archived templates.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"templateId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"The template id (UUID)."},"name":{"type":"string","minLength":1,"maxLength":100,"description":"Template name, unique per workspace (archived templates included)."},"folder":{"description":"Optional folder path for organisation, e.g. \"billing\".","type":"string","maxLength":200},"channelKind":{"type":"string","enum":["email_html","fcm_basic","slack_text","discord_text","telegram_text","sms_text","webhook_json"],"description":"Which channel family the template renders for. Must match the `templateKind` of the channels you will send through (list_channels). Can't be changed after creation."},"content":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"Channel-shaped template body; the shape is fixed by `channelKind`: email_html → `{ subject, bodyHtml, bodyText }`; fcm_basic → `{ title, body, imageUrl?, data?: { [key]: string } }`; slack_text → `{ text }`; discord_text → `{ content }` (max 2000 chars); telegram_text → `{ text, disableLinkPreview? }`; sms_text → `{ text }` (plain text, max 1600; long text is split into several billed SMS — on sendsms_mn into parts of 159 plain-Latin / 69 Cyrillic chars); webhook_json → `{ title, body, data?: { [key]: string } }`. Use `{{name}}` placeholders and `{{#items}}…{{/items}}` sections; the required params are derived from them automatically."},"logTitle":{"type":"string","minLength":1,"maxLength":500,"description":"Short title shown in the in-app feed and delivery logs, e.g. \"Invoice {{number}} is due\". Placeholders allowed."},"logDescription":{"type":"string","minLength":1,"maxLength":2000,"description":"One-line description for the in-app feed and delivery logs. Placeholders allowed."},"paramOverrides":{"description":"Per-param metadata keyed by param name: `{ optional?: boolean, description?: string }`. Mark a placeholder optional so sends may omit it.","type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","properties":{"optional":{"type":"boolean"},"description":{"type":"string","maxLength":500}}}},"publish":{"description":"true = publish this version immediately so sends by templateId use it. Default false (saved as draft).","type":"boolean"}},"required":["templateId","name","channelKind","content","logTitle","logDescription"],"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"update_webhook","description":"Change a webhook (PATCH /tenant-webhooks/{id}; write scope). Only the fields you pass change; pass at least one. `rotateSecret: true` issues a new signing secret, returned once in the response, and the old secret stops verifying immediately, so the receiving service must be updated at the same time.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"webhookId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"The webhook id (UUID)."},"name":{"description":"New label.","type":"string","minLength":1,"maxLength":100},"url":{"description":"New public HTTPS endpoint.","type":"string"},"events":{"description":"Replaces the subscribed events. Events to receive: \"notification.delivered\", \"notification.failed_terminal\" (one per recipient), and \"send.completed\" (once per send, with status totals).","minItems":1,"type":"array","items":{"type":"string","enum":["notification.delivered","notification.failed_terminal","send.completed"]}},"enabled":{"description":"false pauses deliveries without deleting the webhook.","type":"boolean"},"rotateSecret":{"description":"true rotates the signing secret (new secret returned once; old one invalid immediately).","type":"boolean"}},"required":["webhookId"],"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"whoami","description":"Identify the API key this connection uses (GET /me): `tenantId` (the workspace), `apiKeyId` and `scopes`. Write tools need the `write` scope; call this to check before attempting them.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#"}}],"scan":{"score":90,"grade":"A","scanned_at":"2026-09-19T19:54:38.387Z","report":{"scannerVersion":"0.1.5","scannedAt":"2026-09-19T19:54:38.350Z","components":{"code":{"score":25,"max":25,"notes":["2 source files scanned"]},"reliability":{"score":20,"max":20,"notes":["remote reachable in 1365ms"]},"poisoning":{"score":15,"max":15,"notes":["21 tool descriptions checked"]},"auth":{"score":8,"max":15,"notes":["API key sent as a header"]},"maintenance":{"score":15,"max":15,"notes":["last push 0 days ago"]},"identity":{"score":7,"max":10,"notes":["registry namespace matches repository owner"]}},"findings":[],"inputs":{"probes":[{"url":"https://ray-api.gege.mn/mcp","reachable":true,"authRequired":false,"latencyMs":1365,"serverInfo":{"name":"ray","version":"0.1.0"}}],"packages":[{"registryType":"npm","identifier":"@gege-mn/ray-mcp","version":"0.1.0","found":true,"license":"MIT","hasInstallScripts":false,"dependencyCount":1,"publishedAt":"2026-09-14T17:13:11.013Z","repositoryUrl":"git+https://github.com/gege-mn/ray-mcp.git","weeklyDownloads":149}],"repo":{"found":true,"owner":"gege-mn","repo":"ray-mcp","archived":false,"pushedAt":"2026-09-19T13:04:35Z","stars":0,"forks":0,"openIssues":0,"ownerType":"Organization","ownerAvatarUrl":"https://avatars.githubusercontent.com/u/301638712?v=4","ownerCreatedAt":"2026-07-09T07:27:22Z","license":"MIT"},"icon":{"url":"https://avatars.githubusercontent.com/u/301638712?v=4&s=128","source":"registry","width":128,"height":128},"presence":{"stars":0,"forks":0,"downloadsWeek":149,"license":"MIT","lastPushAt":"2026-09-19T13:04:35.000Z","score":34}}}},"grade_history":[],"reviews":[]}