# Maildeck API > Maildeck sells and runs cold-email infrastructure: inboxes on dedicated sending domains, delivered into your > own sequencer. This API and MCP server let an agent price and buy a plan (through a payment link a person > pays), finish the order setup, set up domain masking, watch blacklists, and ask Maya, the built-in assistant. - REST base: https://api.maildeck.co/v1 - MCP (Streamable HTTP): https://api.maildeck.co/mcp - OpenAPI: https://api.maildeck.co/v1/openapi.json ## Getting in MCP apps (Claude, ChatGPT, Cursor, Claude Code): add the MCP address as a connector. The app signs the person in to Maildeck (OAuth 2.1 with PKCE; metadata under /.well-known/) and they approve what it may do. Scripts and servers: send "Authorization: Bearer ". A person creates keys in Maildeck under Settings, API & MCP. Scopes: read (see the account), billing (quotes and payment links), write (setup, masking, connections). ## Rules - Nothing is ever charged through the API. create_checkout returns a payment link for a person to pay. - Every write takes an idempotency_key; repeating it returns the first result. - create_checkout, complete_order_setup, enable_masking and disable_masking need confirm: true. - Logins and API keys can be sent in but are never returned. - Cancelling a subscription is done by a person in the app, not through the API. - Start with get_account_status: it lists what the account has and the next actions, most urgent first. ## Operations - start_connect (POST /v1/connect) [no key]: Ask for access to a Maildeck account. Returns a link for the person to approve. - poll_connect (POST /v1/connect/poll) [no key]: Check whether the person approved. Returns the API key once, on approval. - get_pricing (GET /v1/pricing) [no key]: List the plans Maildeck sells and their monthly prices. - check_domains (GET /v1/domains/check) [no key]: Check whether a domain name is free to register, with suggestions. - get_account_status (GET /v1/account) [read]: What this account owns and what to do next. Start here. - list_domains (GET /v1/domains) [read]: The domains on this account, with provider, inbox count and status. - get_domain_health (GET /v1/domains/health) [read]: Blacklist monitoring and mail-record health (MX, SPF, DKIM, DMARC) for each domain. - list_orders (GET /v1/orders) [read]: The account's orders, newest first. - get_order (GET /v1/orders/{order_id}) [read]: One order: what was bought, setup status and when it will be ready. - quote_order (POST /v1/quotes) [billing]: Price an order exactly, without creating anything. - create_checkout (POST /v1/checkouts) [billing]: Create a payment link for a plan. A person opens it and pays; nothing is charged by this call. - get_checkout (GET /v1/checkouts/{checkout_id}) [read]: Has the payment link been paid yet? Returns the order once it has. - get_order_setup (GET /v1/orders/{order_id}/setup) [read]: The setup checklist of a paid order: what is saved and what is still missing. - update_order_setup (PUT /v1/orders/{order_id}/setup) [write]: Save part of an order's setup: domains, registrar and sequencer access, business details. - complete_order_setup (POST /v1/orders/{order_id}/setup/complete) [write]: Finish setup so Maildeck starts building the inboxes. Cannot be undone through the API. - list_domain_replacements (GET /v1/domains/replacements) [read]: This account's domain replacement requests and where each one stands. - check_replacement_domains (POST /v1/domains/replacements/check) [write]: Check whether new domains are fit to replace burned ones. Changes nothing. - request_domain_replacements (POST /v1/domains/replacements) [write]: Ask Maildeck to replace burned domains. The team rebuilds the inboxes at no charge. - withdraw_domain_replacement (POST /v1/domains/replacements/{request_id}/withdraw) [write]: Take back a replacement request the team has not started. - get_masking (GET /v1/masking) [read]: Masking status of every domain, and the DNS provider keys on file. - get_masking_guide (GET /v1/masking/guide) [read]: Which DNS providers masking supports, and exactly which key each one needs. - add_masking_credential (POST /v1/masking/credentials) [write]: Connect a DNS provider API key so masking can set DNS records. - enable_masking (POST /v1/masking) [write]: Turn masking on for domains: they will show the destination website. - verify_masking (POST /v1/masking/verify) [write]: Ask for masked domains to be re-checked now (after a DNS or nameserver change). - disable_masking (DELETE /v1/masking) [write]: Turn masking off for domains and remove the DNS records it added. - connect_sequencer (POST /v1/sequencer) [write]: Save the sending tool's API key so Maildeck can read real sending numbers. - connect_calendar (POST /v1/calendar) [write]: Connect Calendly with a personal access token so booked calls are counted. - disconnect_calendar (DELETE /v1/calendar) [write]: Disconnect the calendar. Booked calls stop being counted. - ask_maya (POST /v1/maya/ask) [read]: Ask Maya a question about Maildeck or about this account. Returns her answer as text.