@Odile Labs
Basic information
Transport
Streamable HTTP
Authentication
OAuth
Category
Communication
Author
Odile Labs
Submitted by
tolga-boop
OdileM2M: AI agents reach a real business by its phone number. Look the business up free, then leave a message, check open times or book a slot through Odile Direct. 50 free tasks a month per agent; lookups and availability stay free. The same server also gives your app an answering phone line (25 cents a minute).
https://odilelabs.com/mcpclaude mcp add odilem2m-by-odile-labs --transport http https://odilelabs.com/mcpRead the OdileM2M network, live Direct skills, credit prices, limits, Gate MCP connection and quickstart. Needs no sign-in, contacts no business and changes nothing.
Read factual OdileM2M use cases, connections, first steps, free allowances and limitations for Gate API enforcement and Direct business communication. Needs no sign-in or arguments, reads no account and contacts no business.
Resolve an E.164 number to a public Odile Direct agent card. Free: 30/IP/hour without sign-in; 10000/key/day signed in.
Lookups and availability stay free. Each agent identity gets 50 free tasks per UTC calendar month; then a delivered message costs 1 credit and a confirmed booking 5 credits. 1 credit = $0.10. Direct 100: 100 credits for $10; Direct 1,000: 1,000 credits for $90; Direct 10,000: 10,000 credits for $800. Credits never expire; nothing renews. Failed, refused and unconfirmed tasks cost nothing. Existing prepaid dollar balances keep their full cent value; 10 cents of balance equals 1 credit. Quotes, settlement and agent-to-agent voice are not available. Send take_message, check_availability, book or book_first_available. Keep message_id unchanged on retry. Use target=claim for verified listings. Booking requires the human’s permission; pending deposits are charged only after calendar confirmation.
Read the signed-in account’s UTC free-send allowance, prepaid balance in cents, reserved cents and last 20 charges. Lookups and availability stay free. Each agent identity gets 50 free tasks per UTC calendar month; then a delivered message costs 1 credit and a confirmed booking 5 credits. 1 credit = $0.10. Direct 100: 100 credits for $10; Direct 1,000: 1,000 credits for $90; Direct 10,000: 10,000 credits for $800. Credits never expire; nothing renews. Failed, refused and unconfirmed tasks cost nothing. Existing prepaid dollar balances keep their full cent value; 10 cents of balance equals 1 credit. Quotes, settlement and agent-to-agent voice are not available. Uses the same ledger as REST and your developer page. Requires direct:tasks. Changes nothing; phone minutes and legacy credits are separate.
For an existing deposit booking on your signed-in Direct account, reconcile its Stripe Checkout payment and return its receipt and separate booking state. Requires direct:tasks. Uses only the stored merchant account and amount; creates no new charge or booking identity. A verified paid checkout may finish its already-authorized held booking. Payout status remains unknown; paid does not mean a bank payout. The human pays on Stripe’s hosted page.
The offer for an After Hours AI phone receptionist on the owner's own business line, prepaid and billed per minute: min40: 40 minutes for $10; min200: 200 minutes for $50 ($0.25 a minute). Real answered phone calls cost $0.25 per minute, billed by the second: each call rounds up to the next whole second, with a 20-second minimum. Robocalls, calls from your own numbers or ours, website and widget chats, text messages, and calls whose transcripts cannot be read are not charged. At zero the line keeps answering and usage goes below zero; your next pack pays that balance first. You are emailed at 5 minutes left, at zero, and at 10 minutes below zero. Nothing switches the line off automatically. Offered in: US. Use it before set_up_answering_line, to tell the owner exactly what they would buy. Needs no sign-in, reads no account and changes nothing. Returns { product, packs[{id, minutes, cents}], per_minute_cents, min_billable_seconds, billing_rule, at_zero, countries[], owner_must[], terms_url, set_up_with, top_up_with }.
Free, before buying anything: a shared test phone number and a 4-digit code (valid 24 hours, 5 calls). Calling the number and keying the code reaches an AI receptionist answering as the business described here, and hear_url plays the same receptionist in a browser. Nothing is booked, sent or charged on a test line; it shows how a real one sounds. Needs a signed-in account (any permissions). For a real line on the business's own number, use set_up_answering_line.
Starts an After Hours AI receptionist for the signed-in owner's business, prepaid and billed per minute (min40: 40 minutes for $10; min200: 200 minutes for $50). Real answered phone calls cost $0.25 per minute, billed by the second: each call rounds up to the next whole second, with a 20-second minimum. Robocalls, calls from your own numbers or ours, website and widget chats, text messages, and calls whose transcripts cannot be read are not charged. Nothing is built or bought until the owner pays: this returns a Stripe checkout link for the first pack, and the line (agent and phone number) is set up automatically once that is paid; its number and forwarding codes are then emailed to the account's address. Every line also gets a SIP address on request, so a phone system can send calls to it with no phone number. Only call it after showing the owner https://odilelabs.com/terms and getting a yes. For prices first use get_answering_line_offer; for a line that already exists use get_answering_line, and add minutes to it with buy_pack (product 'line_minutes'), not a second set-up. United States only (the business line and the owner's mobile must be US numbers). Needs a signed-in connection with the lines:manage permission; limited to 3 set-ups a day per account. Returns { setup_id, status: 'awaiting payment', business_name, business_phone, pack, minutes, price_cents, checkout_url, then }.
Create or read a SIP address and private trunk credentials for one of the signed-in owner's answering lines. Any phone system that can send a call to a SIP address can send calls here with no phone number. SIP calls use the line's normal allowance or prepaid minutes, with no separate SIP price. Keep the returned username and password private. Needs lines:manage.
The signed-in owner's own After Hours lines and pending setups. New lines use phone minutes; existing per-call lines retain calls. Returns billing_mode, balance (seconds for minutes, calls for legacy lines), minutes_remaining to one decimal for minute lines, forwarding codes and recent_calls. Callers are shown by their last four digits only. Needs lines:manage and changes nothing.
The signed-in owner's own line: its calls, newest first. Each item has id, at (ISO), caller (E.164 or null), duration_seconds, summary when there is one, and urgent when known. No audio links; use the owner console to listen. Pass the previous result's next_before as before to page back through older calls. Needs lines:manage and changes nothing.
The signed-in owner's own line: messages the receptionist took, newest first. Each item has id, at (ISO), name, phone, message and urgent. Pass the previous result's next_before as before to page back through older messages. Needs lines:manage and changes nothing.
Odile Labs' published benchmark of AI phone receptionists: real test calls placed to public lines, scored against stated measures. Use it when someone asks how AI receptionists actually handle calls, or to compare named products; call it with no arguments first, then filter. Needs no sign-in and changes nothing. Returns { source, date, calls, minutes, run_by, limitations, fairness_note, scenarios[{id,name,brief}], lines[{id, vendor, business, kind, answers_as, list_price, ranked, points, possible, by_scenario{<scenario_id>:{points, possible, answered, first_words_s, ai_disclosed_unprompted, reply_language, price_quoted, measures}}}], read_more }. An unknown line_id or scenario_id returns an error listing the valid ids. Vendor-run by Odile Labs (which sells After Hours and Dusklin), not independent. It does not test the caller's own line (for that, see read_more.free_line_check); to set up an After Hours line billed per minute, see get_answering_line_offer.
The live price list and limits for Odile Formats, which reformats an existing video or photos for social platforms (it does not pick clips, write captions or edit). Call it first, before estimate_media_job or prepare_upload, to learn the preset and fit names, the file limits and the job flow. Needs no sign-in, takes no arguments and changes nothing. Returns { currency, packs[{id, credits, cents}], free_credits_per_account, credits_valid_months, buy_credits_at, purchasable_through_this_connection: true, how_to_buy, units, presets{video[], photos[]} (preset name strings), fits[] (fit name strings), limits{video_source_bytes, photo_source_bytes, max_source_photos, max_trim_seconds}, flow[] }. Prices are read from the same source the website charges from.
Price an Odile Formats job in credits before anything is uploaded or charged; use it to tell the customer the cost and get their approval before unlock_job. Needs no sign-in and changes nothing. Photos are priced exactly. Reel, Feed and Square video outputs cost exactly 1 credit each; YouTube 16:9 costs 1 or 2 because the length is only known once the file is read. Returns { minimum_credits, maximum_credits, final_price_known, charge_now: 0, why }. An unknown preset or a photo count out of range returns an error naming the valid values (get_catalog lists them).
The signed-in customer's Odile Formats credit balance. Use it before unlock_job to check the job is affordable, or when the customer asks what they have left. Needs a signed-in connection; takes no arguments and changes nothing. Returns { account, credits (whole number, 0 when empty), next_expiry ({ at: epoch milliseconds, credits } for the next credits to lapse, or null), buy_credits_at }. To buy more: buy_pack (needs the billing:checkout permission) returns a checkout link the customer pays on Stripe's own page, or send the customer to buy_credits_at.
One Odile Formats job by id, or the ten most recent when no id is given. Use it to poll a job after create_media_job (every 10-20 seconds, up to 10 minutes) until state is ready or failed; if it is still rendering after that, tell the customer and check again later (nothing is charged until unlock_job). Needs a signed-in connection and changes nothing. Returns one job { job_id, kind, state (queued | rendering | ready | failed), error, unlocked, credits_cost, credits_cost_known, credits_spent, outputs[{name, preset, ready, bytes, duration}], created_at, updated_at }, or { jobs[] } of the same shape. credits_cost is final only once credits_cost_known is true. An id that is not on this account returns 'No such job'. It reports status only: the files come from get_downloads after unlock_job, and a price before uploading comes from estimate_media_job.
Signed download links for every finished file of a job, once unlock_job has succeeded for it. Use it as the last step of the flow, and again whenever links have expired. Needs a signed-in connection and changes nothing. Returns { job_id, files[{name, preset, bytes, width, height, duration, url, expires_at}], how }. Each link works for 15 minutes and needs no login: fetch the files with curl (see how) rather than reading them into the conversation, or, without a shell, give the customer the links to open. Files are kept for 30 days. A job that is not unlocked returns an error with its state and cost; call unlock_job first.
Step one of an Odile Formats job: returns a 30-minute upload token and the helper command. Run the helper in a shell on the customer's machine: file bytes go straight to Odile and never enter this conversation. The helper prints the source keys to pass to create_media_job. Needs a signed-in connection with write access; nothing is charged. Returns { kind, upload_token, expires_at, helper_url, run[], accepts, part_size, note }. One video OR up to ten photos per job. Each call mints a new token; earlier tokens stay valid until their own expiry, so call it again only when a token has expired or for a new job. To price a job first use estimate_media_job; for the file limits use get_catalog.
Queue an Odile Formats job from sources uploaded with prepare_upload's helper. Costs nothing: credits are only spent by unlock_job, after the customer approves. One set of uploads makes exactly one job: calling it again with the same sources returns the existing job (replayed: true) whatever outputs, fit or trim are passed, so to render different outputs, upload again with prepare_upload. Needs a signed-in connection with write access. Returns at once with the job (same shape as get_job) plus replayed and next; poll get_job until state is ready.
Spends the customer's credits to unlock a finished job's files. Only call once get_job says the job is ready and the customer has approved a maximum spend. Refuses, charging nothing, if the job costs more than max_credits, is not ready, or the balance is short (the error says which, with the amount needed). A job that is already unlocked comes back as it is, with no charge and no balance or max_credits check. Needs a signed-in connection with spend access. Returns the job (same shape as get_job, with unlocked: true) plus credits_left and next: 'get_downloads'.
Direct prepaid packs: direct100c or direct1000 or direct10000. Lookups and availability stay free. Each agent identity gets 50 free tasks per UTC calendar month; then a delivered message costs 1 credit and a confirmed booking 5 credits. 1 credit = $0.10. Direct 100: 100 credits for $10; Direct 1,000: 1,000 credits for $90; Direct 10,000: 10,000 credits for $800. Credits never expire; nothing renews. Failed, refused and unconfirmed tasks cost nothing. Existing prepaid dollar balances keep their full cent value; 10 cents of balance equals 1 credit. Quotes, settlement and agent-to-agent voice are not available. Returns a one-time Stripe checkout link for a prepaid pack; the customer opens it and pays on Stripe's own page, and this connection never sees the card. Only call it when the customer asked to buy, and tell them the price first. Products: 'formats' (Odile Formats credits; packs from get_catalog), 'minutes' (meeting minutes, only where Meeting Notes is on), 'line_minutes' (phone minutes for a new After Hours line; line_id required: min40: 40 minutes for $10; min200: 200 minutes for $50), 'photos' (Plate API photo credits: starter: 1000 photos for $10; growth: 5000 photos for $45; scale: 20000 photos for $160), 'calls' (legacy per-call lines only). What was paid is added within a minute of payment, whatever device paid it. Nothing renews. Needs a signed-in connection with the billing:checkout permission. Returns { checkout_url, product, pack, price_cents, units, unit, then }.
Reads a photo of a meal or drink (the Plate API, SPEC-plate-api.md) and returns its items with grams, calories, protein and likely allergens -- guesses from the usual recipe, not a promise the dish is free of one, and not medical advice. A photo with no food costs nothing; one with food spends 1 Plate API photo credit, a balance separate from Odile Formats credits (get_balance). The first 25 are free on every account, granted automatically the first time this is called. Needs a signed-in connection with the media:spend permission. Returns { items[{name, grams, calories, protein_g, allergens}], allergens, total_calories, total_protein_g, confidence, note, credits_left }, or an error with credits_left and buy_credits_at when the balance is short.
Most small businesses have no API, but every one has a phone number. OdileM2M lets an AI agent reach a participating business by that number.
find_business_agent: look a business up by its E.164 phone number (free).send_to_business: leave a message, check open times, book an offered slot, or book the first available time in up to five preferred windows.The agent asks the person before every send, says it is an automated assistant, and uses the person's own callback number. A task is done only when its state is TASK_STATE_COMPLETED; a booking only when the result says booked: true.
curl -fsS https://odilelabs.com/m2m-quickstart.sh | sh
Runs four tasks against a fictional demo business. Nothing is charged and nobody is contacted.
50 free tasks a month per agent. Then 1 credit per delivered message and 5 per confirmed booking; a credit is $0.10, sold in one-time packs. Lookups and availability stay free.
The OdileM2M by Odile Labs remote MCP server is a hosted Model Context Protocol endpoint at https://odilelabs.com/mcp, so AI assistants can connect to it without installing or running anything locally.
Add the endpoint https://odilelabs.com/mcp to any MCP-compatible client such as Claude Code, Cursor, or VS Code. The setup snippets on this page configure each client in one step.
Yes. OdileM2M by Odile Labs uses OAuth: the first time you connect, your MCP client opens a browser window to sign in and authorize access, then reuses the credentials for future sessions.
OdileM2M by Odile Labs exposes a Streamable HTTP endpoint, the transport used by remote MCP servers and supported by all major MCP clients.
%20-%20Sarah%20Xu.svg){kind=icon}
Understand and troubleshoot your Journeys and Campaigns
Hosted AdLoop: Google Ads, Reddit Ads, GA4 and Tag Manager in claude.ai, ChatGPT and more, with a preview before every change.
Official 42min MCP server: let Claude, ChatGPT, Cursor or any MCP client manage your meeting scheduling. Check availability, find free slots, book, cancel and reschedule meetings, manage recurring series, secret booking
AdaptlyPost: Schedule and publish social posts to Instagram, TikTok, YouTube, X, Facebook, LinkedIn, Pinterest, Threads, and Bluesky from any MCP client.
Aard connects Macroeconomic and other official data from 170+ publishers including World Bank, IMF, BIS, ECB, Eurostat, and National Statistical Offices. Aard is powered by a large graph of the metadata universe and an
Comments