Skip to content

us.telcodata/telcodata

us.telcodata/telcodatatelcodata.usstreamable-httpv1.0.0Scanned

North American telephone numbering data: carriers, rate centers, OCNs, and number history.

21 tools: 1 change things and 20 only read.

Tools: 0 delete, 0 irreversible, 1 write, 20 read.
  • Reads private data · 2
  • Reads text others write · 0
  • Can send data out · 0
  • No findings

Anlyon alternative

1 of these tools change something. Run those as governed actions.

Declare what an action changes, and Anlyon puts it under a shared limit, binds every approval to the exact request, and grades the outcome. It works on any HTTPS API you can describe as an action.

Anlyon does not run, proxy or govern this MCP server. A tool your own code calls directly is not routed through Anlyon and is not governed by it.

Import an OpenAPI spec →

Tools

Grouped by what each tool does, most consequential first. Open one for its reasons and full description; descriptions are the publisher's own words.

21 tools

Changes things 1Claude Code: ask
  • geocode_addressGeocode a U.S.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    Geocode a U.S. street address with TelcoData's local TIGER/Line database. For Canadian addresses, return the direct Natural Resources Canada Geolocator URL instead of proxying the Canadian query.
Only reads 20Show 20 read-only tools
  • get_download_metadataFetch metadata for a specific paid download without transferring file contents.Reads private dataNo findings

    Why it is in this group

    • The name "get_download_metadata" says "get": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "fetch" and "file": it reads files.
    Description, as the server wrote it
    Fetch metadata for a specific paid download without transferring file contents. Use after list_downloads when the user asks about one dataset's suggested filename, access level, availability, file existence, or last-updated time.
  • get_exchangeLook up a single NANP NPA-NXX exchange/prefix.No findings

    Why it is in this group

    • The name "get_exchange" says "get": a word for reading.
    Description, as the server wrote it
    Look up a single NANP NPA-NXX exchange/prefix. Use when the user has an area code plus exchange such as 425-555, or when deriving the prefix from a phone number is unnecessary. Set include_blocks=true when the user needs portability/pooling detail, the responsible carrier may vary by thousands digit, or the answer should show all block-level assignments. TelcoData fields commonly include npa, exchange/NXX, thousands, state, country, ratecenter, company, ocn, lata, switch CLLI, and tandem CLLI. A thousands value of -1 represents the whole prefix/default aggregate; 0-9 are individual thousand-number pooling blocks.
  • get_exchange_thousandsLook up one thousands block within an NPA-NXX.No findings

    Why it is in this group

    • The name "get_exchange_thousands" says "get": a word for reading.
    Description, as the server wrote it
    Look up one thousands block within an NPA-NXX. Use when the user gives the seventh digit of a NANP number, such as 425-555-4XXX, or asks who owns/routes a specific block. If no block row exists, the tool reports whether it used the -1 aggregate/default row. TelcoData fields commonly include npa, exchange/NXX, thousands, state, country, ratecenter, company, ocn, lata, switch CLLI, and tandem CLLI. A thousands value of -1 represents the whole prefix/default aggregate; 0-9 are individual thousand-number pooling blocks.
  • get_meReturn the authenticated TelcoData account profile for the provided API key.No findings

    Why it is in this group

    • The name "get_me" says "get": a word for reading.
    Description, as the server wrote it
    Return the authenticated TelcoData account profile for the provided API key. Use this to confirm entitlement level, API access, expiration, and identity before explaining why a query or download may be unavailable.
  • get_ocn_profileFetch carrier profile details for a 4-character Operating Company Number (OCN).No findings

    Why it is in this group

    • The name "get_ocn_profile" says "get": a word for reading.
    Description, as the server wrote it
    Fetch carrier profile details for a 4-character Operating Company Number (OCN). Use when the user asks who an OCN belongs to, wants carrier type/country, or needs FCC FRN/RMD and Canadian registration/contact fields tied to that carrier.
  • get_switchFetch central-office/switch detail for one 11-character CLLI code.No findings

    Why it is in this group

    • The name "get_switch" says "get": a word for reading.
    Description, as the server wrote it
    Fetch central-office/switch detail for one 11-character CLLI code. Use when the user asks about a switch, wire center, location, equipment/switch type, LATA, tandem, point code, or English name tied to a CLLI. The officetype field contains space-separated raw NECA Tariff 4 office-capability codes; it is not the equipment model in switchtype. For prefixes served by a switch, start with get_exchange or related prefix-listing tools.
  • list_area_code_exchangesList all exchanges/prefixes in a NANP area code.No findings

    Why it is in this group

    • The name "list_area_code_exchanges" says "list": a word for reading.
    Description, as the server wrote it
    List all exchanges/prefixes in a NANP area code. Use for area-code inventory, coverage, or 'what prefixes exist in 425' questions. Set include_blocks=true only when the user asks for every thousand block or pooling-level detail, because that can return many more rows. TelcoData fields commonly include npa, exchange/NXX, thousands, state, country, ratecenter, company, ocn, lata, switch CLLI, and tandem CLLI. A thousands value of -1 represents the whole prefix/default aggregate; 0-9 are individual thousand-number pooling blocks.
  • list_downloadsList paid downloadable TelcoData datasets visible to the authenticated user, including entitlement/access flags.No findings

    Why it is in this group

    • The name "list_downloads" says "list": a word for reading.
    Description, as the server wrote it
    List paid downloadable TelcoData datasets visible to the authenticated user, including entitlement/access flags. Use when the user asks what bulk data files, CSVs, database dumps, or paid downloads their account can access.
  • list_lata_prefixesList prefixes in a Local Access and Transport Area (LATA).No findings

    Why it is in this group

    • The name "list_lata_prefixes" says "list": a word for reading.
    Description, as the server wrote it
    List prefixes in a Local Access and Transport Area (LATA). Use for regional telecom market/routing questions such as all prefixes in a LATA. LATAs are telecom routing/market areas and do not necessarily match states, cities, or area codes. TelcoData fields commonly include npa, exchange/NXX, thousands, state, country, ratecenter, company, ocn, lata, switch CLLI, and tandem CLLI. A thousands value of -1 represents the whole prefix/default aggregate; 0-9 are individual thousand-number pooling blocks.
  • list_new_exchangesList newly assigned TelcoData exchanges for a date range.No findings

    Why it is in this group

    • The name "list_new_exchanges" says "list": a word for reading.
    Description, as the server wrote it
    List newly assigned TelcoData exchanges for a date range. Use for recent numbering activity, new prefix reports, and state-filtered change monitoring. Defaults to the last 30 days when dates are omitted; pass explicit YYYY-MM-DD dates when the user gives a period. Results are exchange-level additions, not live telephone-number assignment events.
  • list_ocn_prefixesList NPA-NXX prefixes assigned to an Operating Company Number (OCN).No findings

    Why it is in this group

    • The name "list_ocn_prefixes" says "list": a word for reading.
    Description, as the server wrote it
    List NPA-NXX prefixes assigned to an Operating Company Number (OCN). Use when the user asks where a carrier operates, what prefixes belong to a carrier, or wants to pivot from an OCN profile into numbering footprint. Combine with get_ocn_profile for carrier identity fields. TelcoData fields commonly include npa, exchange/NXX, thousands, state, country, ratecenter, company, ocn, lata, switch CLLI, and tandem CLLI. A thousands value of -1 represents the whole prefix/default aggregate; 0-9 are individual thousand-number pooling blocks.
  • list_state_area_codesList NANP area codes for a state, province, or supported NANP country/territory code.No findings

    Why it is in this group

    • The name "list_state_area_codes" says "list": a word for reading.
    Description, as the server wrote it
    List NANP area codes for a state, province, or supported NANP country/territory code. Use for quick geography-to-NPA mapping before deeper area-code or rate-center queries.
  • list_tandem_prefixesList prefixes routed via a tandem switch CLLI.No findings

    Why it is in this group

    • The name "list_tandem_prefixes" says "list": a word for reading.
    Description, as the server wrote it
    List prefixes routed via a tandem switch CLLI. Use for routing and interconnection questions, or when the user has a tandem CLLI and wants all served prefixes. The input may be a 6- to 11-character CLLI prefix; broader prefixes can return more rows. TelcoData fields commonly include npa, exchange/NXX, thousands, state, country, ratecenter, company, ocn, lata, switch CLLI, and tandem CLLI. A thousands value of -1 represents the whole prefix/default aggregate; 0-9 are individual thousand-number pooling blocks.
  • lookup_acnaLook up CIC rows by 3-letter Access Customer Name Abbreviation (ACNA).No findings

    Why it is in this group

    • The name "lookup_acna" says "lookup": a word for reading.
    Description, as the server wrote it
    Look up CIC rows by 3-letter Access Customer Name Abbreviation (ACNA). Use when the user has an ACNA and wants associated carrier identification codes or carrier names.
  • lookup_cicLook up a 4-digit Carrier Identification Code (CIC/PIC) record.No findings

    Why it is in this group

    • The name "lookup_cic" says "lookup": a word for reading.
    Description, as the server wrote it
    Look up a 4-digit Carrier Identification Code (CIC/PIC) record. Use for questions about long-distance carrier selection codes, 1010 dialing, or mapping a CIC to carrier/ACNA data.
  • lookup_tnNormalize a dialable telephone number to E.164 and identify country metadata.No findings

    Why it is in this group

    • The name "lookup_tn" says "lookup": a word for reading.
    Description, as the server wrote it
    Normalize a dialable telephone number to E.164 and identify country metadata. Prefer this whenever the user gives a full phone number. For NANP numbers, it returns the most specific TelcoData exchange or thousands-block record and shows whether the lookup used block detail or fallback. TelcoData fields commonly include npa, exchange/NXX, thousands, state, country, ratecenter, company, ocn, lata, switch CLLI, and tandem CLLI. A thousands value of -1 represents the whole prefix/default aggregate; 0-9 are individual thousand-number pooling blocks.
  • search_carrier_profiles_by_frnList carrier profiles sharing an FCC Registration Number (FRN).No findings

    Why it is in this group

    • The name "search_carrier_profiles_by_frn" says "search": a word for reading.
    Description, as the server wrote it
    List carrier profiles sharing an FCC Registration Number (FRN). Use to group related OCNs, carrier names, and RMD records under a common FCC registration.
  • search_carrier_profiles_by_rmd_idList carrier profiles sharing an FCC Robocall Mitigation Database filing ID.Reads private dataNo findings

    Why it is in this group

    • The name "search_carrier_profiles_by_rmd_id" says "search": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "list" and "database": it reads databases.
    Description, as the server wrote it
    List carrier profiles sharing an FCC Robocall Mitigation Database filing ID. Use to connect multiple OCNs or brands to the same RMD filing/contact when investigating carrier identity, voice providers, or robocall-mitigation relationships.
  • search_ratecenterSearch exchanges/prefixes for a rate center within a state, province, or NANP country code.No findings

    Why it is in this group

    • The name "search_ratecenter" says "search": a word for reading.
    Description, as the server wrote it
    Search exchanges/prefixes for a rate center within a state, province, or NANP country code. Use for local-service geography questions such as 'prefixes in the Seattle rate center' or 'which exchanges are in Hamilton, BM'. Rate-center names are telecom rate-center labels, not always postal city names. Set include_blocks=true for pooling detail. TelcoData fields commonly include npa, exchange/NXX, thousands, state, country, ratecenter, company, ocn, lata, switch CLLI, and tandem CLLI. A thousands value of -1 represents the whole prefix/default aggregate; 0-9 are individual thousand-number pooling blocks.
  • search_record_historySearch TelcoData's tracked source-record changes in reverse chronological order.No findings

    Why it is in this group

    • The name "search_record_history" says "search": a word for reading.
    Description, as the server wrote it
    Search TelcoData's tracked source-record changes in reverse chronological order. Use this for questions about when an NPA-NXX or thousands block changed carrier, OCN, CLLI/switch, assignment status, rate center, or another tracked field. Filters are combined, and omitting all filters returns the most recent changes. Initial baseline-load events are excluded. Multi-field record changes are returned together as structured old/new JSON values rather than one unrelated result per changed field. The clli filter matches switch-related changes and accepts a 6- to 11-character CLLI or prefix. Use field for a lowercase source field name, source for the tracked source name, and limit to cap results.

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Exfil surface

Which tools read private data, which read text someone else can write, and which can send data out. One of each is a path a prompt injection can use.

No private-data, untrusted-input, outbound path in this server alone: no tool is tagged untrusted-input or outbound.

Reads private data2
Reads files, mail, messages, databases, secrets, calendars or repositories.
Reads text others write0
Brings in text someone else can write: web pages, inbound email, messages, issues and comments.
Can send data out0
Can carry data to people or systems: it sends, posts or publishes, or takes a recipient, channel or URL.

Other servers in the same agent add their own tools to these paths. Audit your whole setup to see them together.

Findings

Matches of fixed checks, with the text they matched.

No check matched anything in these tool definitions. That is not a safety guarantee.

History

Changes to its tool definitions and to its remote endpoint, newest first.

No change seen yet. Its tools are rescanned every day, and a remote endpoint is looked at once a week.

Install

Pinned to version 1.0.0. Values in angle brackets are yours to fill in.

claude mcp add --transport http telcodata https://api.telcodata.us/mcp --header 'Authorization: <your-authorization>'
claude mcp add --transport http telcodata https://api.telcodata.us/mcp --header 'Authorization: <your-authorization>'

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change or a way out, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__telcodata__get_me",
      "mcp__telcodata__get_exchange",
      "mcp__telcodata__search_record_history",
      "mcp__telcodata__get_exchange_thousands",
      "mcp__telcodata__lookup_tn",
      "mcp__telcodata__list_area_code_exchanges",
      "mcp__telcodata__search_ratecenter",
      "mcp__telcodata__list_new_exchanges",
      "mcp__telcodata__lookup_cic",
      "mcp__telcodata__lookup_acna",
      "mcp__telcodata__get_ocn_profile",
      "mcp__telcodata__search_carrier_profiles_by_rmd_id",
      "mcp__telcodata__search_carrier_profiles_by_frn",
      "mcp__telcodata__list_ocn_prefixes",
      "mcp__telcodata__list_tandem_prefixes",
      "mcp__telcodata__list_lata_prefixes",
      "mcp__telcodata__list_state_area_codes",
      "mcp__telcodata__get_switch",
      "mcp__telcodata__list_downloads",
      "mcp__telcodata__get_download_metadata"
    ],
    "ask": [
      "mcp__telcodata__geocode_address"
    ],
    "deny": []
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. A read that can send data out (it takes a URL, say) asks first too. It assumes the server is installed as telcodata. Review it before you use it.

Capability tags behind 2 rules
  • mcp__telcodata__search_carrier_profiles_by_rmd_id private-data
  • mcp__telcodata__get_download_metadata private-data

Pin

Keep the decision: fail CI when the tools change, follow every change, or show a badge.

Pin in CI

Fail a build when the tools you reviewed are not the tools the server serves today.

curl -s "https://anlyon.dev/api/v1/servers/us.telcodata/telcodata/verify?hash=5382ea99949a15327f080a9bc08d7dd0b2ee6c92c2ef13c80840d62fd9fa2b99" | jq -e '.changed == false'

Pinned hash 5382ea99949a, from Oct 26, 2026, 23:18 UTC.

Watch

Get told when its tools change: a new tool, a new description, a new class.

https://anlyon.dev/servers/us.telcodata/telcodata/changes.xml

An Atom feed. Works in any feed reader or Slack's RSS app.

Badge

anlyon.dev badge for us.telcodata/telcodata
[![anlyon.dev](https://anlyon.dev/badge/us.telcodata/telcodata.svg)](https://anlyon.dev/servers/us.telcodata/telcodata)

Source: MCP Registry. Synced Oct 26, 2026, 23:18 UTC.