Skip to main content
Glama

Create registration

create_registration
Destructive

Create a 10DLC registration (the carrier registration local numbers need to text the public) and check it: the website, privacy policy, terms, opt-in page and example texts against carrier rules. Returns ready or checks_failed, with each finding, its fix and copy to paste. Nothing goes to the carriers and nothing is billed. Business details come from the person, not from guesses.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "business_name": "<business_name>",
      "website": "<website>",
      "use_case": "<use_case>"
    },
    "name": "create_registration"
  }
}

Input Schema

NameRequiredDescriptionDefault
brandNoThe business as the carriers register it. street must be a street address, not a P.O. box; state a 2-letter US state or territory code; postal_code a 5-digit ZIP (optionally +4). Anything else is refused with 400 naming the field.
websiteYesThe business's own website. Reviewers visit it to confirm the business is real.
use_caseYesWhat the texts are for. marketing and mixed need an opt-in for each person.
age_gatedNoYour messages are for adults only (alcohol, cannabis, gambling).
terms_urlNoDiscovered from homepage links when omitted
help_replyNoYour wording of the HELP reply. It must name your business, give a way to reach you (email, phone or web page) and keep the STOP instruction. Omit or null for the standard wording.
opt_in_urlNoPage where people enter their number
stop_replyNoYour wording of the confirmation sent when someone opts out. It must name your business, say they are unsubscribed, and carry no link; anything else is a 400 naming what is missing. Omit or null for the standard wording in your business name. Filed with the registration and sent by its numbers.
descriptionNoWhat you send and to whom (40 to 500 characters). Omit or null to file the generated one.
opt_in_flowNoHow people opt in, in your own words. It leads the filed opt-in account; the opt-in page, the disclosure and the START keyword are added after it. Omit or null to file the standard sentence.
privacy_urlNoDiscovered from homepage links when omitted
business_nameYesThe name customers know the business by, as the texts will name it.
support_emailNoUsed in the generated HELP reply
direct_lendingNoYour messages are about loans you make yourself.
includes_linksNoYour messages include web links. Also true whenever an example contains one.
sample_messagesNoReal examples of the texts you will send, as a recipient would get them (no template variables). Carriers compare them with your traffic. Each must name your business; marketing and mixed use cases need opt-out wording in at least one. More than 5, or one over 320 characters, is a 400; too few or too short comes back as findings. Omit to get starter drafts; null or [] goes back to them.
starter_messagesNoDraft examples suggested for this business (fields.sample_messages from POST /registrations/prefill). Shown instead of the template starter drafts; samples_source stays starter and they are never filed until you edit or confirm them. Drafts that would not pass the example check for the business name and use case are ignored.
samples_confirmedNotrue = the starter drafts are right as they are; they become your examples. Ignored when sample_messages is sent.
opt_in_screenshot_urlNoPeople opt in inside an app: a public link to an image of that screen. Checked in place of a phone field and filed with the opt-in. null clears it.
includes_phone_numbersNoYour messages include phone numbers. Also true whenever an example contains one.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Added

TDQS

A3.8/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Beyond the annotations, the description discloses that the tool validates website, privacy, terms, opt-in, and sample messages against carrier rules; returns ready or checks_failed with findings, fixes, and paste-ready copy; and neither submits to carriers nor incurs billing. It does not explain authentication needs or the exact meaning of destructiveHint, but it adds substantial behavioral context.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is front-loaded with the core action and check scope, then adds return behavior and side-effect guarantees. Every sentence carries useful information, and there is no redundant or filler wording.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a complex 20-parameter tool with no output schema, the description explains the result states and side effects well enough for an agent to call it correctly. It could better connect the creation step to follow-on submit or phone-code tools, but the essential completeness is present.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the 20 parameters are already well documented in the schema. The description adds high-level meaning by saying the website, privacy policy, terms, opt-in page, and example texts are checked, but it does not add per-parameter guidance beyond that baseline.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific verb and resource: create a 10DLC registration and check the website, privacy policy, terms, opt-in page, and example texts against carrier rules. It clearly distinguishes the pre-submission scope by saying nothing goes to the carriers and nothing is billed, though it does not name siblings such as submit_registration or recheck_registration.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Usage is implied: this is the safe creation-and-check step before actual carrier submission, and business details should come from the user rather than guesses. However, the description does not explicitly say when to use this versus submit_registration, recheck_registration, or enter_registration_phone_code.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.