Koskamo

asms MCP

A native MCP server provided by asms.ai that allows AI agents to autonomously receive SMS verification codes and rent phone numbers. It enables agents to order temporary numbers, poll for incoming SMS messages, and manage rentals, facilitating account verification on various services without human intervention.

Visit asms.ai

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

asms MCP logo, by asms.aiVendor evidenceStreamable HTTPNo sign-inEndpoint checked 2026-11-01Operated by asms.ai
You need:sign in with asms or pass an API keyCreate an account, top up from a few dollars
MCP endpoint (Streamable HTTP)
https://asms.ai/mcp
Vendor documentation

What you can do with it

  • Order a temporary phone number for SMS verification
  • Poll for incoming verification codes on a rented number
  • Check wallet balance and service pricing
  • Cancel orders or rentals for refunds

Source and maintenance

Vendor evidenceRegistry 1.1.0
mcp-registry: ai.asms/asms@1.1.0Source repositoryProject website
Maintenance checked

Protocol and capabilities

Server
asms 1.1.0
MCP protocol
2025-06-18
Tools
12 advertised
Resources
Not advertised
Resource templates
Not advertised
Prompts
Not advertised
Server-advertised capabilities
{
  "tools": {
    "listChanged": false
  }
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

ASMS gives you phone numbers to receive SMS on. For one verification code: get_pricing → create_otp_order → poll_sms until the code arrives. For a number you keep (1 day to 12 months) that receives every SMS sent to it: get_rental_offers → rent_number → read_rental_sms. Orders and rentals are paid from the account wallet; confirm the price with the user before buying.

Tools

12 advertised

get_balance — Wallet balance
Advertised by the server during the last successful anonymous check.
Advertised read-only

Get the current wallet balance for the authenticated account.

get_balance input schema
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
get_balance annotations
{
  "readOnlyHint": true,
  "openWorldHint": false
}
get_pricing — Verification code prices
Advertised by the server during the last successful anonymous check.
Advertised read-only

Get the retail price per OTP activation for a service in a country. Omit `service` to list prices for every available service.

get_pricing input schema
{
  "type": "object",
  "required": [
    "country"
  ],
  "properties": {
    "country": {
      "type": "string",
      "description": "Number pool to order from: \"us1\" = Non-VoIP AT&T (real carrier line, for strict services like WhatsApp/Telegram/Google), \"us\" = VoIP High Quality (lowest price, works for most signups), \"uk\" = United Kingdom (+44), \"au\" = Australia (+61)."
    },
    "service": {
      "type": "string",
      "description": "Service slug to receive the OTP for (e.g. \"google\", \"telegram\", \"whatsapp\")."
    }
  },
  "additionalProperties": false
}
get_pricing annotations
{
  "readOnlyHint": true,
  "openWorldHint": false
}
get_inventory — Verification number stock
Advertised by the server during the last successful anonymous check.
Advertised read-only

Get how many numbers are in stock for a service in a country. Omit `service` to list stock for every available service.

get_inventory input schema
{
  "type": "object",
  "required": [
    "country"
  ],
  "properties": {
    "country": {
      "type": "string",
      "description": "Number pool to order from: \"us1\" = Non-VoIP AT&T (real carrier line, for strict services like WhatsApp/Telegram/Google), \"us\" = VoIP High Quality (lowest price, works for most signups), \"uk\" = United Kingdom (+44), \"au\" = Australia (+61)."
    },
    "service": {
      "type": "string",
      "description": "Service slug to receive the OTP for (e.g. \"google\", \"telegram\", \"whatsapp\")."
    }
  },
  "additionalProperties": false
}
get_inventory annotations
{
  "readOnlyHint": true,
  "openWorldHint": false
}
create_otp_order — Order a verification number
Advertised by the server during the last successful anonymous check.
Advertised destructiveOpen-world

Buy a number to receive an OTP: allocates a number, debits the wallet, and returns an orderId + phoneNumber. Then poll with poll_sms. If no code arrives, do NOT cancel to retry: simply call create_otp_order again for a fresh number and keep polling that one. Unfilled orders auto-refund within 10 minutes, so you only pay for codes that actually land and there is no penalty for ordering repeatedly. When a service keeps rejecting codes, order on the "us1" (Non-VoIP AT&T) pool, which has the highest delivery rate. WARNING: this spends real wallet balance.

create_otp_order input schema
{
  "type": "object",
  "required": [
    "country",
    "service"
  ],
  "properties": {
    "country": {
      "type": "string",
      "description": "Number pool to order from: \"us1\" = Non-VoIP AT&T (real carrier line, for strict services like WhatsApp/Telegram/Google), \"us\" = VoIP High Quality (lowest price, works for most signups), \"uk\" = United Kingdom (+44), \"au\" = Australia (+61)."
    },
    "service": {
      "type": "string",
      "description": "Service slug to receive the OTP for (e.g. \"google\", \"telegram\", \"whatsapp\")."
    }
  },
  "additionalProperties": false
}
create_otp_order annotations
{
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": true
}
poll_sms — Check for the verification code
Advertised by the server during the last successful anonymous check.
Advertised read-only

Check for the SMS / OTP code on an order. Returns the code once it has arrived, otherwise an empty result: poll again after a few seconds. If nothing lands after a minute or two, the fastest path is to order a fresh number with create_otp_order (prefer the "us1" Non-VoIP pool) and leave the original: it auto-refunds within 10 minutes. Never cancel just to retry, and there is no charge for ordering again, you only pay for codes that arrive.

poll_sms input schema
{
  "type": "object",
  "required": [
    "orderId"
  ],
  "properties": {
    "orderId": {
      "type": "string",
      "description": "The orderId from create_otp_order."
    }
  },
  "additionalProperties": false
}
poll_sms annotations
{
  "readOnlyHint": true,
  "openWorldHint": false
}
list_active_orders — List verification orders
Advertised by the server during the last successful anonymous check.
Advertised read-only

List recent OTP orders for the account (awaiting a code or already received).

list_active_orders input schema
{
  "type": "object",
  "properties": {
    "limit": {
      "type": "number",
      "description": "Max orders to return (default 50, max 1000)."
    }
  },
  "additionalProperties": false
}
list_active_orders annotations
{
  "readOnlyHint": true,
  "openWorldHint": false
}
cancel_order — Cancel a verification order
Advertised by the server during the last successful anonymous check.
Advertised destructiveOpen-world

Rarely needed. To retry a verification do NOT cancel: just call create_otp_order again, because every unfilled order auto-refunds within 10 minutes on its own, and cancel is blocked for the first 10 minutes anyway. Only use this to release an order you are certain you no longer need once its 10-minute hold has passed.

cancel_order input schema
{
  "type": "object",
  "required": [
    "orderId"
  ],
  "properties": {
    "orderId": {
      "type": "string",
      "description": "The orderId from create_otp_order."
    }
  },
  "additionalProperties": false
}
cancel_order annotations
{
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": true
}
get_rental_offers — Number rental prices
Advertised by the server during the last successful anonymous check.
Advertised read-only

List the rental periods and prices for a country (1 day to 12 months). A rented number is yours for the whole period and receives every SMS sent to it, unlike an OTP order, which is for one code. Omit `country` to list the countries numbers can be rented in.

get_rental_offers input schema
{
  "type": "object",
  "properties": {
    "country": {
      "enum": [
        "us",
        "uk",
        "ca",
        "au",
        "es",
        "se",
        "de",
        "nl",
        "it",
        "pl",
        "fi",
        "pt",
        "be",
        "at",
        "ch",
        "cz",
        "si",
        "lt",
        "mx",
        "hk",
        "il",
        "za"
      ],
      "type": "string",
      "description": "Country to rent a number in: \"us\" (United States), \"uk\" (United Kingdom), \"ca\" (Canada), \"au\" (Australia), \"es\" (Spain), \"se\" (Sweden), \"de\" (Germany), \"nl\" (Netherlands), \"it\" (Italy), \"pl\" (Poland), \"fi\" (Finland), \"pt\" (Portugal), \"be\" (Belgium), \"at\" (Austria), \"ch\" (Switzerland), \"cz\" (Czechia), \"si\" (Slovenia), \"lt\" (Lithuania), \"mx\" (Mexico), \"hk\" (Hong Kong), \"il\" (Israel), \"za\" (South Africa)."
    }
  },
  "additionalProperties": false
}
get_rental_offers annotations
{
  "readOnlyHint": true,
  "openWorldHint": false
}
rent_number — Rent a phone number
Advertised by the server during the last successful anonymous check.
Advertised destructiveOpen-world

Rent a phone number in a country for a period (get the periods and prices from get_rental_offers first). Debits the wallet and returns the number and when the rental ends. Read its SMS with read_rental_sms. WARNING: this spends real wallet balance; confirm the country, period and price with the user first.

rent_number input schema
{
  "type": "object",
  "required": [
    "country",
    "period"
  ],
  "properties": {
    "period": {
      "enum": [
        "oneDay",
        "oneWeek",
        "oneMonth",
        "threeMonths",
        "sixMonths",
        "twelveMonths"
      ],
      "type": "string",
      "description": "Rental period: \"oneDay\" (1 day), \"oneWeek\" (1 week), \"oneMonth\" (1 month), \"threeMonths\" (3 months), \"sixMonths\" (6 months), \"twelveMonths\" (12 months). Not every period is on sale in every country: check get_rental_offers."
    },
    "country": {
      "enum": [
        "us",
        "uk",
        "ca",
        "au",
        "es",
        "se",
        "de",
        "nl",
        "it",
        "pl",
        "fi",
        "pt",
        "be",
        "at",
        "ch",
        "cz",
        "si",
        "lt",
        "mx",
        "hk",
        "il",
        "za"
      ],
      "type": "string",
      "description": "Country to rent a number in: \"us\" (United States), \"uk\" (United Kingdom), \"ca\" (Canada), \"au\" (Australia), \"es\" (Spain), \"se\" (Sweden), \"de\" (Germany), \"nl\" (Netherlands), \"it\" (Italy), \"pl\" (Poland), \"fi\" (Finland), \"pt\" (Portugal), \"be\" (Belgium), \"at\" (Austria), \"ch\" (Switzerland), \"cz\" (Czechia), \"si\" (Slovenia), \"lt\" (Lithuania), \"mx\" (Mexico), \"hk\" (Hong Kong), \"il\" (Israel), \"za\" (South Africa)."
    }
  },
  "additionalProperties": false
}
rent_number annotations
{
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": true
}
list_rentals — List rented numbers
Advertised by the server during the last successful anonymous check.
Advertised read-only

List the account's rented numbers with their country, period and end date. Ended rentals are left out unless `includeEnded` is true.

list_rentals input schema
{
  "type": "object",
  "properties": {
    "includeEnded": {
      "type": "boolean",
      "description": "Also list rentals that have ended (default false)."
    }
  },
  "additionalProperties": false
}
list_rentals annotations
{
  "readOnlyHint": true,
  "openWorldHint": false
}
read_rental_sms — Read a rented number's SMS
Advertised by the server during the last successful anonymous check.
Advertised read-only

Read the SMS a rented number has received during this rental, newest first. Poll again every few seconds while waiting for a message.

read_rental_sms input schema
{
  "type": "object",
  "required": [
    "number"
  ],
  "properties": {
    "number": {
      "type": "string",
      "description": "The rented number, as rent_number or list_rentals gave it (\"+\", spaces and dashes are ignored)."
    }
  },
  "additionalProperties": false
}
read_rental_sms annotations
{
  "readOnlyHint": true,
  "openWorldHint": false
}
cancel_rental — Cancel a rental for a refund
Advertised by the server during the last successful anonymous check.
Advertised destructiveOpen-world

Cancel a rented number and refund it. Only possible between 5 and 120 minutes after renting, and only if the number has received no SMS; after that the rental runs to its end date.

cancel_rental input schema
{
  "type": "object",
  "required": [
    "number"
  ],
  "properties": {
    "number": {
      "type": "string",
      "description": "The rented number, as rent_number or list_rentals gave it (\"+\", spaces and dashes are ignored)."
    }
  },
  "additionalProperties": false
}
cancel_rental annotations
{
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": true
}

Prompts

Not advertised

No prompt definitions available.

Resources

Not advertised

No resource definitions available.

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks
1 of 1 (100%)
Average latency
639 ms
95th percentile latency
639 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 639 ms · metadata changed · 12 tool(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http asms-mcp https://asms.ai/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add asms-mcp --url https://asms.ai/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable asms-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "asms-mcp": {
      "url": "https://asms.ai/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "asms-mcp": {
      "type": "streamableHttp",
      "url": "https://asms.ai/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start asms-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "asms-mcp": {
      "type": "http",
      "url": "https://asms.ai/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http asms-mcp https://asms.ai/mcp

Claude Desktop

Merge this into claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\), then restart Claude Desktop.
Claude Desktop configuration
{
  "mcpServers": {
    "asms-mcp": {
      "url": "https://asms.ai/mcp"
    }
  }
}

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "asms-mcp": {
      "serverUrl": "https://asms.ai/mcp"
    }
  }
}

Let your agent find its tools

Find servers like asms MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows
See all 4,376

Do you run asms MCP?

Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.

Claim this listing