Key Takeaways
- list-devices MCP tool concepts: expose pairing health so the agent does not send OTP to a Dozing phone.
- Confirm the live devices payload in Developer Center — this page is the concept.
- Not a first-party Cursor/Claude plugin. REST wrapper.
- Priced by devices and SMS send volume. You use your own phone and operator SMS credit. A listed device still needs operator credit.
- Free 300 SMS lifetime is one device — listing will not invent slots.
- Last-seen stale ⇒ walk to the cable, do not retry the tool.
Concepts for a list-devices MCP tool exist so agents stop targeting a brick. Overview: MCP overview. Device health thinking. MCP specification.
Priced by devices and SMS send volume. You use your own phone and operator SMS credit.
If list-devices returns one row and last-seen is yesterday, the next send tool is not a retry. It is a person walking to a charger.
List is last-seen, not voltage
Map the documented devices resource. Developer Center. Do not invent battery fields.
What the tool should return
| Field idea | Use | Do not |
|---|---|---|
| Device id | Route send | Guess from nickname only |
| Last-seen | Skip stale | Treat as DLR |
| Your OTP tag | Policy in the wrapper | Assume the API knows login vs promo |
| Slot count | Plan meter awareness | Pretend listing adds devices |
Agents must not pick a dead phone
Fail the tool if nothing is fresh. Error handling.
Not a device picker in Cursor
Tool JSON only. Not a first-party IDE plugin.
OTP pool vs bulk pool
Encode policy in the wrapper. OTP.
Overview vs this spoke
Box diagram on overview. This page is one tool.
Checklist
- Live fields from docs.
- Stale devices excluded from send.
- OTP tag is yours.
- No plugin claims.
- Airtime not in the list payload.
- Human still owns the drawer.
Next steps
Pair via setup, then device caps.
Related product pages
Jump to the live product docs for this topic—not another long-form article.
- SMS API documentationLive endpoint reference
- device and SMS volume pricingPlans and allowances
- Android SMS gateway product guideDefinition, product, and how to buy
- download the Android gateway appGet the APK
