Connect

8 clients · secrets stay placeholders

JSON (mcpServers)Claude CodeCodexOpenCodeCursorVS CodeGemini CLIGoose

{
  "mcpServers": {
    "location": {
      "type": "http",
      "url": "https://roxyapi.com/mcp/location",
      "headers": {
        "X-API-Key": "${X_API_KEY}",
        "Authorization": "${X_API_KEY}"
      }
    }
  }
}

claude mcp add --transport http location https://roxyapi.com/mcp/location --header "X-API-Key: ${X_API_KEY}" --header "Authorization: ${X_API_KEY}"

[mcp_servers.location]
url = "https://roxyapi.com/mcp/location"
env_http_headers = { "X-API-Key" = "X_API_KEY", "Authorization" = "X_API_KEY" }

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "location": {
      "type": "remote",
      "url": "https://roxyapi.com/mcp/location",
      "enabled": true,
      "headers": {
        "X-API-Key": "{env:X_API_KEY}",
        "Authorization": "{env:X_API_KEY}"
      }
    }
  }
}

{
  "mcpServers": {
    "location": {
      "type": "http",
      "url": "https://roxyapi.com/mcp/location",
      "headers": {
        "X-API-Key": "${X_API_KEY}",
        "Authorization": "${X_API_KEY}"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=location&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vcm94eWFwaS5jb20vbWNwL2xvY2F0aW9uIiwiaGVhZGVycyI6eyJYLUFQSS1LZXkiOiIke1hfQVBJX0tFWX0iLCJBdXRob3JpemF0aW9uIjoiJHtYX0FQSV9LRVl9In19"
}

{
  "servers": {
    "location": {
      "type": "http",
      "url": "https://roxyapi.com/mcp/location",
      "headers": {
        "X-API-Key": "${X_API_KEY}",
        "Authorization": "${X_API_KEY}"
      }
    }
  }
}

{
  "mcpServers": {
    "location": {
      "httpUrl": "https://roxyapi.com/mcp/location",
      "headers": {
        "X-API-Key": "${X_API_KEY}",
        "Authorization": "${X_API_KEY}"
      }
    }
  }
}

extensions:
  "location":
    enabled: true
    name: "location"
    type: streamable_http
    uri: "https://roxyapi.com/mcp/location"
    headers:
      "X-API-Key": "${X_API_KEY}"
      "Authorization": "${X_API_KEY}"
    timeout: 300

Placeholders to fill from your own secret store: ${X_API_KEY}, ${X_API_KEY}. The registry never accepts secret values.

Quality 89 / 100good

protocol88 · weight 25

pass
protocol.modernsupports 2026-07-28 (server/discover)
pass
protocol.statelessanswers without a session
pass
protocol.transportstreamable HTTP
warn
protocol.list_ttltools/list declares ttlMs 0, so clients re-fetch it on every use

authorizationn/a · weight 15

n/a
auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
n/a
auth.secret_in_urlno templated URL

tool hygiene86 · weight 30

pass
tools.descriptionsevery tool has a description
pass
tools.description_lengthdescriptions are concise
pass
tools.schemasevery tool has an object input schema
pass
tools.annotations3 of 3 tools declare readOnlyHint or destructiveHint
fail
tools.directory_hintsno tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: get_location_countries (idempotentHint, openWorldHint); get_location_countries_iso2 (idempotentHint, openWorldHint); get_location_search (idempotentHint, openWorldHint)
pass
tools.token_costabout 1,154 tokens to load every tool
pass
tools.api_dumptools are not a one-to-one API dump

stability100 · weight 15

pass
stability.changesno tool changes in 30 days
pass
stability.rug_pullno tool changed its meaning under the same name

dependenciesn/a · weight 15

n/a
deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

3 tools, about 1,154 tokens to load them all · tool set f5415dd46522 · checked 2026-10-19 10:52 UTC

Tool changes

No tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 82 / 100

no-repository

provenance55

liveness97

freshness100

hygiene80

+dns-namespace +website +reachable +uptime-93% +updated-24d-ago -no-repository

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Endpoints

remote	auth	reachable	uptime 30d	p50	protocol	last ok
`https://roxyapi.com/mcp/location` streamable-http	api_key `${X_API_KEY}`	yes	93%	543 ms	2026-07-28	2026-10-19

Tools (3)

`get_location_countries`read-only	Returns every country with ISO 3166-1 alpha-2 and alpha-3 codes, plus the number of searchable cities per country. Use this endpoint to build country dropdown menus, regional filters, or to check city coverage before querying a birth location. Countries are sorted alphabetically by name. Covers Europe, Americas, Asia, Middle East, Africa, and Oceania.
`get_location_countries_iso2`read-only	Returns all cities for a specific country, identified by ISO 3166-1 alpha-2 code (e.g. DE for Germany, FR for France, GB for United Kingdom, US for United States). Each city includes geographic coordinates, IANA timezone, and DST-aware UTC offset for direct use in astrology birth chart, horoscope, transit, and panchang calculations. Cities sorted by population with the largest metropolitan areas first.
`get_location_search`read-only	Turn a place name into coordinates, an IANA timezone and a DST-aware UTC offset, across 235,000+ cities and towns in 240+ countries. Coverage reaches rural towns of a few hundred people and every administrative seat, so a birthplace outside a major metro resolves as reliably as a capital. Matching is case-insensitive, accent-insensitive and partial, so ber matches Berlin, Bern and Bergen, native scripts are transliterated, and historic names resolve to the current place, so bombay returns Mumbai and peking returns Beijing. Results are ordered by match quality first and population second, so an exactly named small town is never buried under a larger city that merely shares its opening letters. Built for birth chart location pickers, horoscope apps, event scheduling, and any feature that needs place-to-coordinates resolution.

Schemas: list_tools.

Similar MCP servers

More from com.roxyapi

And 12 more from this publisher.

Official server.json

{
  "name": "com.roxyapi/location",
  "_meta": {
    "io.modelcontextprotocol.registry/publisher-provided": {
      "supportUrl": "https://roxyapi.com/contact",
      "privacyPolicyUrl": "https://roxyapi.com/policy/privacy",
      "termsOfServiceUrl": "https://roxyapi.com/policy/terms"
    }
  },
  "icons": [
    {
      "src": "https://roxyapi.com/logo.png",
      "sizes": [
        "512x512"
      ],
      "mimeType": "image/png"
    }
  ],
  "title": "Location and Timezone MCP Server by RoxyAPI",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://roxyapi.com/mcp/location",
      "type": "streamable-http",
      "headers": [
        {
          "name": "X-API-Key",
          "isSecret": true,
          "isRequired": true,
          "description": "RoxyAPI key from roxyapi.com/account"
        }
      ]
    }
  ],
  "version": "1.0.1",
  "websiteUrl": "https://roxyapi.com/products/location-api",
  "description": "City geocoding and timezone resolution for birth data, for AI agents, one API key."
}