Cherami · OpenAPI Overlay 1.0.0

Cherami HTTP API: API Evangelist enhancements

50 actions 50 updates update extends ../openapi/_original/cherami-to-openapi.yml
Derived by API Evangelist Built from the contracts Cherami publishes. Cherami did not publish this file.
View Overlay File View on GitHub Overlay Specification

What the actions change

x-mcp-toolx-idempotencyx-mcp-serverx-llms-txt

Targets 41 · first 16 shown; the file carries all of them

$.info
$.paths['/v1/inboxes'].get
$.paths['/v1/inboxes'].post
$.paths['/v1/inboxes/{inbox_id}'].get
$.paths['/v1/inboxes/{inbox_id}/receiving-policy'].get
$.paths['/v1/inboxes/{inbox_id}/sending-policy'].get
$.paths['/v1/inboxes/{inbox_id}'].patch
$.paths['/v1/inboxes/{inbox_id}/messages'].get
$.paths['/v1/inboxes/{inbox_id}/messages/count'].get
$.paths['/v1/messages/{message_id}'].get
$.paths['/v1/inboxes/{inbox_id}/threads'].get
$.paths['/v1/threads/{thread_id}'].get
$.paths['/v1/messages/{message_id}/raw'].get
$.paths['/v1/messages/{message_id}/attachments/{attachment_id}'].get
$.paths['/v1/inboxes/{inbox_id}/drafts'].post
$.paths['/v1/inboxes/{inbox_id}/drafts'].get

OpenAPI Overlay

Raw ↑ 
overlay: 1.0.0
info:
  title: 'Cherami HTTP API: API Evangelist enhancements'
  version: 1.0.0
extends: ../openapi/_original/cherami-to-openapi.yml
x-provenance:
  generated: '2026-11-03'
  method: derived
  source: mcp/cherami-to-tool-crosswalk.yml; idempotency_key request fields in openapi/cherami-to-openapi.yml
actions:
- target: $.info
  update:
    x-mcp-server:
      url: https://cherami.to/mcp
      transport: streamable-http
      auth: oauth (cherami_mail:full) or Cherami API key
      docs: https://cherami.to/docs/mcp
    x-llms-txt: https://cherami.to/llms.txt
- target: $.paths['/v1/inboxes'].get
  update:
    x-mcp-tool: list_inboxes
- target: $.paths['/v1/inboxes'].post
  update:
    x-mcp-tool: create_inbox
- target: $.paths['/v1/inboxes/{inbox_id}'].get
  update:
    x-mcp-tool: get_inbox
- target: $.paths['/v1/inboxes/{inbox_id}/receiving-policy'].get
  update:
    x-mcp-tool: get_receiving_policy
- target: $.paths['/v1/inboxes/{inbox_id}/sending-policy'].get
  update:
    x-mcp-tool: get_sending_policy
- target: $.paths['/v1/inboxes/{inbox_id}'].patch
  update:
    x-mcp-tool: update_inbox
- target: $.paths['/v1/inboxes/{inbox_id}/messages'].get
  update:
    x-mcp-tool: list_messages
- target: $.paths['/v1/inboxes/{inbox_id}/messages/count'].get
  update:
    x-mcp-tool: count_messages
- target: $.paths['/v1/messages/{message_id}'].get
  update:
    x-mcp-tool: get_message
- target: $.paths['/v1/inboxes/{inbox_id}/threads'].get
  update:
    x-mcp-tool: list_threads
- target: $.paths['/v1/threads/{thread_id}'].get
  update:
    x-mcp-tool: get_thread
- target: $.paths['/v1/messages/{message_id}/raw'].get
  update:
    x-mcp-tool: read_raw_message
- target: $.paths['/v1/messages/{message_id}/attachments/{attachment_id}'].get
  update:
    x-mcp-tool: read_attachment
- target: $.paths['/v1/inboxes/{inbox_id}/drafts'].post
  update:
    x-mcp-tool: create_draft
- target: $.paths['/v1/inboxes/{inbox_id}/drafts'].get
  update:
    x-mcp-tool: list_drafts
- target: $.paths['/v1/drafts/{draft_id}'].get
  update:
    x-mcp-tool: get_draft
- target: $.paths['/v1/drafts/{draft_id}'].patch
  update:
    x-mcp-tool: update_draft
- target: $.paths['/v1/drafts/{draft_id}/send'].post
  update:
    x-mcp-tool: send_draft
- target: $.paths['/v1/drafts/{draft_id}'].delete
  update:
    x-mcp-tool: delete_draft
- target: $.paths['/v1/inboxes/{inbox_id}/sent'].post
  update:
    x-mcp-tool: send_message
- target: $.paths['/v1/inboxes/{inbox_id}/reply'].post
  update:
    x-mcp-tool: reply_message
- target: $.paths['/v1/inboxes/{inbox_id}/reply-all'].post
  update:
    x-mcp-tool: reply_all_message
- target: $.paths['/v1/inboxes/{inbox_id}/forward'].post
  update:
    x-mcp-tool: forward_message
- target: $.paths['/v1/inboxes/{inbox_id}/sent'].get
  update:
    x-mcp-tool: list_sent
- target: $.paths['/v1/sent/{message_id}'].get
  update:
    x-mcp-tool: get_sent_message
- target: $.paths['/v1/messages/{message_id}'].patch
  update:
    x-mcp-tool: update_message_labels
- target: $.paths['/v1/sent/{message_id}'].patch
  update:
    x-mcp-tool: update_sent_message_labels
- target: $.paths['/v1/inboxes/{inbox_id}/labels'].get
  update:
    x-mcp-tool: list_labels
- target: $.paths['/v1/messages/labels'].patch
  update:
    x-mcp-tool: bulk_update_message_labels
- target: $.paths['/v1/sent/labels'].patch
  update:
    x-mcp-tool: bulk_update_sent_message_labels
- target: $.paths['/v1/threads/{thread_id}'].patch
  update:
    x-mcp-tool: update_thread_labels
- target: $.paths['/v1/outbound/quota'].get
  update:
    x-mcp-tool: get_outbound_quota
- target: $.paths['/v1/messages/{message_id}'].delete
  update:
    x-mcp-tool: delete_message
- target: $.paths['/v1/sent/{message_id}'].delete
  update:
    x-mcp-tool: delete_sent_message
- target: $.paths['/v1/threads/{thread_id}'].delete
  update:
    x-mcp-tool: delete_thread
- target: $.paths['/v1/inboxes/{inbox_id}'].delete
  update:
    x-mcp-tool: delete_inbox
- target: $.paths['/v1/inboxes/{inbox_id}/trash'].get
  update:
    x-mcp-tool: list_trash
- target: $.paths['/v1/messages/{message_id}/restore'].post
  update:
    x-mcp-tool: restore_message
- target: $.paths['/v1/sent/{message_id}/restore'].post
  update:
    x-mcp-tool: restore_sent_message
- target: $.paths['/v1/feedback'].post
  update:
    x-mcp-tool: submit_feedback
- target: $.paths['/v1/inboxes'].post
  update:
    x-idempotency:
      supported: true
      field: idempotency_key
      source: openapi/cherami-to-openapi.yml
- target: $.paths['/v1/inboxes/{inbox_id}'].patch
  update:
    x-idempotency:
      supported: true
      field: idempotency_key
      source: openapi/cherami-to-openapi.yml
- target: $.paths['/v1/inboxes/{inbox_id}/sent'].post
  update:
    x-idempotency:
      supported: true
      field: idempotency_key
      source: openapi/cherami-to-openapi.yml
- target: $.paths['/v1/inboxes/{inbox_id}/reply'].post
  update:
    x-idempotency:
      supported: true
      field: idempotency_key
      source: openapi/cherami-to-openapi.yml
- target: $.paths['/v1/inboxes/{inbox_id}/reply-all'].post
  update:
    x-idempotency:
      supported: true
      field: idempotency_key
      source: openapi/cherami-to-openapi.yml
- target: $.paths['/v1/inboxes/{inbox_id}/forward'].post
  update:
    x-idempotency:
      supported: true
      field: idempotency_key
      source: openapi/cherami-to-openapi.yml
- target: $.paths['/v1/inboxes/{inbox_id}/drafts'].post
  update:
    x-idempotency:
      supported: true
      field: idempotency_key
      source: openapi/cherami-to-openapi.yml
- target: $.paths['/v1/drafts/{draft_id}'].patch
  update:
    x-idempotency:
      supported: true
      field: idempotency_key
      source: openapi/cherami-to-openapi.yml
- target: $.paths['/v1/drafts/{draft_id}/send'].post
  update:
    x-idempotency:
      supported: true
      field: idempotency_key
      source: openapi/cherami-to-openapi.yml

Work with this as data

Every overlay here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for openapi overlays

4 MCP tools reach this
  • find_overlaysBrowse and filter every overlay in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This overlay 
curl "https://apis.io/api/v1/overlays/cherami-to-agent-overlay"
All openapi overlays 
curl "https://apis.io/api/v1/overlays?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.