Server definition
- Hash
- sha256:6df044fcfc032e419755fba92868626be6fb0e177c39df53f44289f7726eced3
- What it is
- What a remote MCP server returned when asked what it offers: 16 tools
The blob, as servednamed by its sha256
{
"instructions": null,
"tools": [
{
"description": "Order new US phone numbers on your MeiSIM account, paid from its prepaid wallet. Prepaid: no returns, no refunds once a number is delivered. Choose billing \"daily\" (a minimum number of days paid now, then each day from the wallet) or \"monthly\" (a minimum number of months paid up front). A monthly order also says line_history: \"fresh\" or \"any\"; ask the user which. Call get_number_pricing first and tell the user the total. Numbers usually land within about 15 minutes; check with get_order. Safe to retry with the same customer_reference. Needs your API key.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"area_code": {
"description": "Preferred 3-digit US area code, if available.",
"pattern": "^\\d{3}$",
"type": "string"
},
"billing": {
"description": "\"daily\" or \"monthly\". See get_number_pricing.",
"enum": [
"daily",
"monthly"
],
"type": "string"
},
"count": {
"description": "How many numbers.",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"customer_reference": {
"description": "Your own reference for this order; a repeat with the same reference returns the first order.",
"maxLength": 120,
"type": "string"
},
"days": {
"description": "Daily billing only: days to pay now (at least the minimum).",
"maximum": 365,
"minimum": 1,
"type": "integer"
},
"line_history": {
"description": "Monthly billing: \"fresh\" for a number no other account has held (no refund if the carrier blocks it), or \"any\" for a number from stock that may have been used before. Required for monthly orders.",
"enum": [
"fresh",
"any"
],
"type": "string"
},
"months": {
"description": "Monthly billing only: months to pay up front (at least the minimum).",
"maximum": 12,
"minimum": 1,
"type": "integer"
},
"voice": {
"description": "Also calls over SIP (costs more; must be enabled on the account).",
"type": "boolean"
},
"zip_code": {
"description": "5-digit US ZIP to pick the number's area, if available.",
"pattern": "^\\d{5}$",
"type": "string"
}
},
"required": [
"count",
"billing"
],
"type": "object"
},
"name": "buy_numbers",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"billing": {
"type": "string"
},
"charged_usd": {
"type": [
"number",
"null"
]
},
"completed_at": {
"type": [
"string",
"null"
]
},
"created_at": {
"type": [
"string",
"null"
]
},
"customer_reference": {
"type": [
"string",
"null"
]
},
"days_paid": {
"type": [
"number",
"null"
]
},
"delivered": {
"type": "number"
},
"duplicate": {
"type": "boolean"
},
"note": {
"type": "string"
},
"numbers": {
"items": {
"type": "string"
},
"type": "array"
},
"order_id": {
"type": "string"
},
"ordered": {
"type": "number"
},
"outstanding": {
"type": "number"
},
"refunded_usd": {
"type": "number"
},
"status": {
"type": "string"
},
"voice": {
"type": "boolean"
}
},
"required": [
"order_id",
"customer_reference",
"status",
"ordered",
"delivered",
"outstanding",
"numbers",
"billing",
"voice",
"days_paid",
"charged_usd",
"refunded_usd",
"created_at",
"completed_at",
"duplicate",
"note"
],
"type": "object"
}
},
{
"description": "Show the MeiSIM account behind your API key: company, status, prepaid wallet balance in USD, and how many new numbers you may still activate today. Use before buy_numbers, or when the user asks what is left. Needs your API key.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"type": "object"
},
"name": "get_account",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"balance_usd": {
"type": "number"
},
"company": {
"type": [
"string",
"null"
]
},
"currency": {
"type": "string"
},
"daily_line_limit": {
"type": [
"number",
"null"
]
},
"email": {
"type": [
"string",
"null"
]
},
"lines_remaining_today": {
"type": [
"number",
"null"
]
},
"status": {
"type": [
"string",
"null"
]
},
"topup_note": {
"type": "string"
}
},
"required": [
"company",
"email",
"status",
"balance_usd",
"currency",
"daily_line_limit",
"lines_remaining_today",
"topup_note"
],
"type": "object"
}
},
{
"description": "Get the eSIM install QR code, activation (LPA) string, and status for an order. Pass the order_id from purchase. Status is \"ready\" when the profile can be installed (after the customer pays).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"order_id": {
"description": "The order_id returned by purchase.",
"type": "string"
}
},
"required": [
"order_id"
],
"type": "object"
},
"name": "get_activation",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"activation_code": {
"type": [
"string",
"null"
]
},
"expires_at": {
"type": [
"string",
"null"
]
},
"install_instructions": {
"additionalProperties": false,
"properties": {
"android": {
"type": "string"
},
"ios": {
"type": "string"
}
},
"required": [
"ios",
"android"
],
"type": "object"
},
"qr_code_png_base64": {
"type": [
"string",
"null"
]
},
"status": {
"type": "string"
}
},
"required": [
"status",
"install_instructions"
],
"type": "object"
}
},
{
"description": "MeiSIM's current offer for real US phone lines used by AI agents: the monthly price per number for texts, and for texts plus voice over SIP; the first-term minimum; what a line includes (a real US mobile number on a national carrier, inbound texts to a webhook or over the API, voice over SIP with the number as caller ID, one call at a time, outbound calls to US numbers only); delivery time; payment methods; the lower price per line for more lines and who to write to from 1,000 lines; and links to apply and to the API docs. For people building voice agents, phone assistants, companion apps or SMS customer service who ask what a line costs, what it includes or how to get one. Takes no input. Read-only: it cannot open an account or order a line.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"type": "object"
},
"name": "get_ai_line_offer",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"apply_url": {
"type": "string"
},
"currency": {
"type": "string"
},
"delivery": {
"additionalProperties": false,
"properties": {
"account": {
"type": "string"
},
"from_stock": {
"type": "string"
},
"new_number": {
"type": "string"
}
},
"required": [
"from_stock",
"new_number",
"account"
],
"type": "object"
},
"docs_url": {
"type": "string"
},
"how_to_get_one": {
"type": "string"
},
"includes": {
"items": {
"type": "string"
},
"type": "array"
},
"min_months": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"monthly": {
"additionalProperties": false,
"properties": {
"note": {
"type": "string"
},
"texts_usd": {
"type": "number"
},
"voice_usd": {
"type": "number"
}
},
"required": [
"texts_usd",
"voice_usd",
"note"
],
"type": "object"
},
"payment_methods": {
"items": {
"type": "string"
},
"type": "array"
},
"price_ladder": {
"items": {
"additionalProperties": false,
"properties": {
"from_lines": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"texts_usd": {
"type": "number"
},
"to_lines": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"voice_usd": {
"type": "number"
}
},
"required": [
"from_lines",
"to_lines",
"texts_usd",
"voice_usd"
],
"type": "object"
},
"type": "array"
},
"price_ladder_applies_to": {
"type": "string"
},
"price_ladder_ask_from_lines": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"product": {
"type": "string"
},
"term_note": {
"type": "string"
},
"usage_billed_separately": {
"type": "boolean"
},
"volume_contact": {
"type": "string"
},
"volume_pricing": {
"type": "string"
}
},
"required": [
"product",
"currency",
"monthly",
"usage_billed_separately",
"min_months",
"term_note",
"includes",
"delivery",
"payment_methods",
"volume_pricing",
"volume_contact",
"apply_url",
"docs_url",
"how_to_get_one"
],
"type": "object"
}
},
{
"description": "Show what a new US number costs on your MeiSIM account and whether you can order: the daily rate (minimum days, one-time activation fee, how many are ready right now) and the monthly rate (first month, renewals, minimum months), with and without voice. Call before buy_numbers. Needs your API key.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"type": "object"
},
"name": "get_number_pricing",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"can_order": {
"type": "boolean"
},
"currency": {
"type": "string"
},
"daily": {
"additionalProperties": false,
"properties": {
"activation_fee_usd": {
"type": [
"number",
"null"
]
},
"available": {
"type": "boolean"
},
"min_days": {
"type": [
"number",
"null"
]
},
"note": {
"type": [
"string",
"null"
]
},
"price_usd": {
"type": [
"number",
"null"
]
},
"voice_activation_fee_usd": {
"type": [
"number",
"null"
]
},
"voice_price_usd": {
"type": [
"number",
"null"
]
}
},
"required": [
"available",
"price_usd",
"voice_price_usd",
"min_days",
"activation_fee_usd",
"voice_activation_fee_usd",
"note"
],
"type": "object"
},
"monthly": {
"additionalProperties": false,
"properties": {
"first_month_usd": {
"type": [
"number",
"null"
]
},
"min_months": {
"type": "number"
},
"renew_price_usd": {
"type": [
"number",
"null"
]
},
"voice_price_usd": {
"type": [
"number",
"null"
]
}
},
"required": [
"first_month_usd",
"renew_price_usd",
"min_months",
"voice_price_usd"
],
"type": "object"
},
"reason": {
"type": "string"
},
"voice_available": {
"type": "boolean"
},
"voice_note": {
"type": [
"string",
"null"
]
}
},
"required": [
"can_order",
"currency"
],
"type": "object"
}
},
{
"description": "Check a number order from buy_numbers: status (provisioning, partially_fulfilled, fulfilled, delayed, cancelled, closed_refunded), the numbers delivered so far and what was charged. Pass the order_id or your customer_reference. Needs your API key.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"order": {
"description": "The order_id or the customer_reference.",
"maxLength": 120,
"type": "string"
}
},
"required": [
"order"
],
"type": "object"
},
"name": "get_order",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"billing": {
"type": "string"
},
"charged_usd": {
"type": [
"number",
"null"
]
},
"completed_at": {
"type": [
"string",
"null"
]
},
"created_at": {
"type": [
"string",
"null"
]
},
"customer_reference": {
"type": [
"string",
"null"
]
},
"days_paid": {
"type": [
"number",
"null"
]
},
"delivered": {
"type": "number"
},
"numbers": {
"items": {
"type": "string"
},
"type": "array"
},
"order_id": {
"type": "string"
},
"ordered": {
"type": "number"
},
"outstanding": {
"type": "number"
},
"refunded_usd": {
"type": "number"
},
"status": {
"type": "string"
},
"voice": {
"type": "boolean"
}
},
"required": [
"order_id",
"customer_reference",
"status",
"ordered",
"delivered",
"outstanding",
"numbers",
"billing",
"voice",
"days_paid",
"charged_usd",
"refunded_usd",
"created_at",
"completed_at"
],
"type": "object"
}
},
{
"description": "Confirm the current USD price for a specific eSIM plan before purchasing. Returns the full plan plus a price breakdown and a short-lived quote. Call after search_plans, before purchase.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"plan_id": {
"description": "The plan_id (productId) returned by search_plans.",
"type": "string"
}
},
"required": [
"plan_id"
],
"type": "object"
},
"name": "get_quote",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"buy_url": {
"type": "string"
},
"how_to_buy": {
"type": "string"
},
"plan": {
"additionalProperties": false,
"properties": {
"buy_url": {
"type": "string"
},
"country": {
"type": "string"
},
"country_name": {
"type": "string"
},
"coverage": {
"enum": [
"country",
"regional"
],
"type": "string"
},
"coverage_countries": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"currency": {
"type": "string"
},
"data_gb": {
"type": [
"number",
"null"
]
},
"duration_days": {
"type": "number"
},
"network_carriers": {
"items": {
"type": "string"
},
"type": "array"
},
"notes": {
"type": "string"
},
"plan_id": {
"type": "string"
},
"price": {
"type": "number"
},
"unlimited_voice": {
"type": "boolean"
},
"vendor": {
"type": "string"
}
},
"required": [
"plan_id",
"country",
"country_name",
"data_gb",
"duration_days",
"price",
"currency",
"network_carriers"
],
"type": "object"
},
"quote_expires_at": {
"type": "string"
},
"total": {
"additionalProperties": false,
"properties": {
"currency": {
"type": "string"
},
"fees": {
"type": "number"
},
"final": {
"type": "number"
},
"subtotal": {
"type": "number"
},
"taxes": {
"type": "number"
}
},
"required": [
"subtotal",
"taxes",
"fees",
"final",
"currency"
],
"type": "object"
}
},
"required": [
"plan",
"total",
"quote_expires_at"
],
"type": "object"
}
},
{
"description": "List the US phone numbers on your MeiSIM account: number, status, whether it has voice, how it is billed and the date it is paid through. Paged; pass next_offset to continue. Needs your API key.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"description": "Numbers per page, default 100.",
"maximum": 500,
"minimum": 1,
"type": "integer"
},
"offset": {
"description": "Where to start; use next_offset from the previous page.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"search": {
"description": "Optional: part of a number or a label to filter by.",
"maxLength": 40,
"type": "string"
}
},
"type": "object"
},
"name": "list_my_numbers",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"incoming": {
"items": {},
"type": "array"
},
"next_offset": {
"type": [
"number",
"null"
]
},
"note": {
"type": "string"
},
"numbers": {
"items": {
"additionalProperties": false,
"properties": {
"auto_renew": {
"type": "boolean"
},
"billing": {
"type": "string"
},
"billing_note": {
"type": [
"string",
"null"
]
},
"customer_reference": {
"type": [
"string",
"null"
]
},
"e164": {
"type": "string"
},
"label": {
"type": [
"string",
"null"
]
},
"last_message_at": {
"type": [
"string",
"null"
]
},
"number": {
"type": "string"
},
"order_id": {
"type": [
"string",
"null"
]
},
"paid_through": {
"type": [
"string",
"null"
]
},
"status": {
"type": "string"
},
"stops_at_local": {
"type": [
"string",
"null"
]
},
"voice": {
"type": "boolean"
}
},
"required": [
"number",
"e164",
"label",
"status",
"voice",
"billing",
"paid_through",
"auto_renew",
"stops_at_local",
"billing_note",
"order_id",
"customer_reference",
"last_message_at"
],
"type": "object"
},
"type": "array"
},
"total": {
"type": "number"
}
},
"required": [
"numbers",
"total",
"next_offset"
],
"type": "object"
}
},
{
"description": "Begin buying an eSIM plan. Returns a secure Stripe payment link the customer opens to pay with their own card; the eSIM + QR are emailed automatically once payment clears. Poll get_activation with the returned order_id to fetch the QR. Safe to retry with the same idempotency_key.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"billing_country": {
"maxLength": 2,
"minLength": 2,
"type": "string"
},
"customer_email": {
"description": "Where the eSIM/QR is emailed after payment.",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"type": "string"
},
"idempotency_key": {
"description": "Generated if omitted. Reusing a key returns the first checkout instead of starting another.",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$",
"type": "string"
},
"payment_method": {
"description": "Not used: payment happens on the hosted Stripe page via payment_url. Reserved for a future direct-charge path.",
"properties": {
"token": {
"type": "string"
},
"type": {
"enum": [
"stored_card",
"stripe_payment_method"
],
"type": "string"
}
},
"required": [
"type",
"token"
],
"type": "object"
},
"plan_id": {
"description": "The plan_id (productId) to buy, from search_plans / get_quote.",
"type": "string"
}
},
"required": [
"plan_id",
"customer_email"
],
"type": "object"
},
"name": "purchase",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"error": {
"type": "string"
},
"idempotency_key": {
"type": "string"
},
"idempotent": {
"type": "boolean"
},
"message": {
"type": "string"
},
"order_id": {
"type": "string"
},
"payment_url": {
"type": [
"string",
"null"
]
},
"receipt_url": {
"type": [
"string",
"null"
]
},
"status": {
"type": "string"
}
},
"required": [
"order_id",
"status"
],
"type": "object"
}
},
{
"description": "Read the text messages received on your MeiSIM numbers, newest first. Filter to one number and/or to messages after a timestamp. To follow a conversation, pass the received_at of the last message you saw as since. Needs your API key.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"description": "Default 50.",
"maximum": 200,
"minimum": 1,
"type": "integer"
},
"number": {
"description": "One of your numbers, e.g. \"4234322309\" or \"+1 423 432 2309\". Omit for all numbers.",
"maxLength": 20,
"type": "string"
},
"since": {
"description": "ISO 8601 timestamp; only messages received after it.",
"maxLength": 40,
"type": "string"
}
},
"type": "object"
},
"name": "read_messages",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"count": {
"type": "number"
},
"messages": {
"items": {
"additionalProperties": false,
"properties": {
"from": {
"type": "string"
},
"id": {
"type": "string"
},
"number": {
"type": "string"
},
"received_at": {
"type": [
"string",
"null"
]
},
"text": {
"type": "string"
}
},
"required": [
"id",
"number",
"from",
"text",
"received_at"
],
"type": "object"
},
"type": "array"
},
"newest_received_at": {
"type": [
"string",
"null"
]
},
"note": {
"type": "string"
}
},
"required": [
"messages",
"count",
"newest_received_at"
],
"type": "object"
}
},
{
"description": "Search travel eSIM data plans for a destination country. Returns plans with data allowance, validity in days, and USD price. Use this first when a user wants mobile data for a trip (e.g. \"5GB in Italy for 10 days\"). Returns a plan_id to pass to get_quote / purchase.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"country_code": {
"description": "Destination country as an ISO 3166-1 alpha-2 code, e.g. \"IT\" for Italy.",
"maxLength": 2,
"minLength": 2,
"pattern": "^[A-Za-z]{2}$",
"type": "string"
},
"data_gb": {
"description": "Minimum data in GB. Omit to return all sizes (unlimited plans always pass).",
"exclusiveMinimum": 0,
"type": "number"
},
"duration_days": {
"description": "Days of coverage needed. Plans shorter than this are filtered out.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"sort_by": {
"default": "price",
"description": "Result ordering. \"price\" = cheapest first (default).",
"enum": [
"price",
"data_per_dollar",
"duration"
],
"type": "string"
}
},
"required": [
"country_code",
"duration_days"
],
"type": "object"
},
"name": "search_plans",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"how_to_buy": {
"type": "string"
},
"meta": {
"additionalProperties": false,
"properties": {
"returned_at": {
"type": "string"
},
"source": {
"type": "string"
},
"total_results": {
"type": "number"
}
},
"required": [
"total_results",
"source"
],
"type": "object"
},
"plans": {
"items": {
"additionalProperties": false,
"properties": {
"buy_url": {
"type": "string"
},
"country": {
"type": "string"
},
"country_name": {
"type": "string"
},
"coverage": {
"enum": [
"country",
"regional"
],
"type": "string"
},
"coverage_countries": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"currency": {
"type": "string"
},
"data_gb": {
"type": [
"number",
"null"
]
},
"duration_days": {
"type": "number"
},
"network_carriers": {
"items": {
"type": "string"
},
"type": "array"
},
"notes": {
"type": "string"
},
"plan_id": {
"type": "string"
},
"price": {
"type": "number"
},
"unlimited_voice": {
"type": "boolean"
},
"vendor": {
"type": "string"
}
},
"required": [
"plan_id",
"country",
"country_name",
"data_gb",
"duration_days",
"price",
"currency",
"network_carriers"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"plans",
"meta"
],
"type": "object"
}
},
{
"description": "Find real US phone-number plans (a genuine US carrier line with calls, texts, and data, no SSN or contract). Use this when the user wants an actual US number, not just travel data. Returns a plan_id for purchase.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"max_price_usd": {
"description": "Optional max monthly price in USD.",
"exclusiveMinimum": 0,
"type": "number"
}
},
"type": "object"
},
"name": "search_us_numbers",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"how_to_buy": {
"type": "string"
},
"meta": {
"additionalProperties": false,
"properties": {
"returned_at": {
"type": "string"
},
"source": {
"type": "string"
},
"total_results": {
"type": "number"
}
},
"required": [
"total_results",
"source"
],
"type": "object"
},
"plans": {
"items": {
"additionalProperties": false,
"properties": {
"buy_url": {
"type": "string"
},
"carrier": {
"type": "string"
},
"currency": {
"type": "string"
},
"data_gb": {
"type": [
"number",
"null"
]
},
"duration_days": {
"type": "number"
},
"includes_us_number": {
"type": "boolean"
},
"plan_id": {
"type": "string"
},
"price": {
"type": "number"
},
"sms": {
"type": [
"string",
"null"
]
},
"title": {
"type": "string"
},
"voice": {
"type": [
"string",
"null"
]
}
},
"required": [
"plan_id",
"carrier",
"title",
"data_gb",
"duration_days",
"price",
"currency",
"voice",
"sms",
"includes_us_number"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"plans",
"meta"
],
"type": "object"
}
},
{
"description": "Send a text message from one of your MeiSIM numbers to a US number. Sending must be enabled on your account and each number has a monthly allowance; a refusal tells you which. The answer means accepted by the carrier: a mobile line has no delivery receipt. The same text to more than three numbers from one line inside an hour is refused (carriers drop that as a broadcast); write to each person in their own words. Not for emergency services. Needs your API key.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"from": {
"description": "One of your numbers.",
"maxLength": 20,
"type": "string"
},
"message": {
"description": "The text to send, up to 800 characters.",
"maxLength": 800,
"minLength": 1,
"type": "string"
},
"to": {
"description": "The destination number, e.g. \"+1 212 555 0100\".",
"maxLength": 20,
"type": "string"
}
},
"required": [
"from",
"to",
"message"
],
"type": "object"
},
"name": "send_message",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"from": {
"type": "string"
},
"note": {
"type": [
"string",
"null"
]
},
"sent": {
"type": "boolean"
},
"to": {
"type": "string"
}
},
"required": [
"sent",
"from",
"to",
"note"
],
"type": "object"
}
},
{
"description": "Look up an existing US prepaid line (by phone) or an eSIM (by ICCID / order) and list the top-up plans available for it. Returns product_ids to pass to topup_start.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"carrier": {
"description": "Carrier name/id (for us_prepaid; see topup carriers).",
"type": "string"
},
"email": {
"description": "Customer email (required for esim lookup).",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"type": "string"
},
"iccid": {
"description": "eSIM ICCID (for esim).",
"type": "string"
},
"line_type": {
"description": "\"us_prepaid\" for a US phone line, \"esim\" for a travel eSIM.",
"enum": [
"us_prepaid",
"esim"
],
"type": "string"
},
"phone": {
"description": "US phone number (for us_prepaid).",
"type": "string"
}
},
"required": [
"line_type"
],
"type": "object"
},
"name": "topup_lookup",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"hint": {
"type": "string"
},
"lines": {
"items": {
"additionalProperties": false,
"properties": {
"carrier": {
"type": [
"string",
"null"
]
},
"carrier_id": {
"type": [
"number",
"null"
]
},
"iccid": {
"type": [
"string",
"null"
]
},
"line_label": {
"type": "string"
},
"line_type": {
"type": "string"
},
"phone": {
"type": [
"string",
"null"
]
},
"plan_title": {
"type": [
"string",
"null"
]
},
"source_order_id": {
"type": [
"string",
"null"
]
},
"topups": {
"items": {
"additionalProperties": false,
"properties": {
"data": {
"type": "string"
},
"description": {
"type": "string"
},
"is_range": {
"type": "boolean"
},
"max": {
"type": "number"
},
"min": {
"type": "number"
},
"price": {
"type": "number"
},
"product_id": {
"type": "string"
},
"validity": {
"type": "string"
}
},
"required": [
"product_id",
"description",
"data",
"validity",
"price",
"is_range"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"line_type",
"line_label",
"phone",
"iccid",
"carrier",
"carrier_id",
"source_order_id",
"plan_title",
"topups"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"lines"
],
"type": "object"
}
},
{
"description": "Start a top-up/recharge for an existing line or eSIM, using a product_id from topup_lookup. Returns an order_id and a payment URL where the customer completes payment. For range plans, pass custom_amount.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"carrier": {
"type": "string"
},
"custom_amount": {
"description": "For range/RTR plans only.",
"exclusiveMinimum": 0,
"type": "number"
},
"customer_email": {
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"type": "string"
},
"iccid": {
"description": "eSIM ICCID (esim).",
"type": "string"
},
"line_type": {
"enum": [
"us_prepaid",
"esim"
],
"type": "string"
},
"phone": {
"description": "US phone (us_prepaid).",
"type": "string"
},
"product_id": {
"description": "Top-up plan id from topup_lookup.",
"type": "string"
},
"source_order_id": {
"description": "Original eSIM order id (esim).",
"type": "string"
}
},
"required": [
"line_type",
"product_id",
"customer_email"
],
"type": "object"
},
"name": "topup_start",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"amount": {
"type": "number"
},
"currency": {
"type": "string"
},
"error": {
"type": "string"
},
"message": {
"type": "string"
},
"order_id": {
"type": "string"
},
"payment_url": {
"type": [
"string",
"null"
]
},
"product": {
"type": "string"
},
"status": {
"type": "string"
}
},
"required": [
"order_id",
"status",
"amount",
"currency"
],
"type": "object"
}
},
{
"description": "Wait for the next text message on one of your MeiSIM numbers and return it. Blocks up to timeout_seconds (default 30, max 50). Pass since as the time you started waiting (default: now) so an older message is not mistaken for the new one. If nothing arrives, received is false; call again to keep waiting. Needs your API key.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"number": {
"description": "One of your numbers. Omit to watch every number on the account.",
"maxLength": 20,
"type": "string"
},
"since": {
"description": "ISO 8601; only a message received after this counts. Default: now.",
"maxLength": 40,
"type": "string"
},
"timeout_seconds": {
"description": "How long to wait, default 30.",
"maximum": 50,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"name": "wait_for_message",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"messages": {
"items": {
"additionalProperties": false,
"properties": {
"from": {
"type": "string"
},
"id": {
"type": "string"
},
"number": {
"type": "string"
},
"received_at": {
"type": [
"string",
"null"
]
},
"text": {
"type": "string"
}
},
"required": [
"id",
"number",
"from",
"text",
"received_at"
],
"type": "object"
},
"type": "array"
},
"note": {
"type": "string"
},
"received": {
"type": "boolean"
},
"since": {
"type": "string"
},
"waited_seconds": {
"type": "number"
}
},
"required": [
"received",
"messages",
"waited_seconds",
"since"
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:6df044fcfc032e419755fba92868626be6fb0e177c39df53f44289f7726eced3 | sha256sum