Location Search (City, State, Region, or Country)

omnial/location-search

Search for a location by name -- optionally restricted to city, state, region, or country -- and get back matching location records with a canonical name, location type, and a permalink slug identifying each one.

activeper callv3

Price

$0.001 per call

You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $5.00.

Data source

Fundable

Data from Fundable.

Use it

Your AI assistant does the work: it finds this tool, shows you the price first, runs it, and you are charged when the run finishes. There is nothing to set up for this tool in particular.

Connect once and your AI can find and run this tool, and any other it needs.

Install it Create an account

For developers: the calls your assistant makes

agent

// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "omnial/location-search" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/location-search" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/location-search", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/location-search", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.

Pricing

Every charge this tool can incur.

Charge	Price
Per call	$0.001

Updated: Oct 27, 2026

Input and output schemas

Input schema

input_schema.json

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "description": "Location name; fuzzy matched."
    },
    "type": {
      "enum": [
        "CITY",
        "STATE",
        "REGION",
        "COUNTRY"
      ],
      "type": "string",
      "description": "Restrict to one location level."
    }
  },
  "additionalProperties": false
}

Output schema

output_schema.json

{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "locations": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "The matched location's display name, e.g. 'London'."
              },
              "permalink": {
                "type": "string",
                "description": "A stable, URL-safe slug identifying this specific location record, disambiguating same-named places, e.g. 'london-england' vs. 'london-ontario' vs. 'london-kentucky'."
              },
              "location_type": {
                "type": "string",
                "description": "One of CITY, STATE, REGION, COUNTRY."
              }
            },
            "additionalProperties": true
          },
          "description": "Empty array on a no-match search; one entry per matching location otherwise -- a search for 'London' returned 9 entries, including near-misses like 'Londonderry' and 'New London', not just exact name matches."
        },
        "totalCount": {
          "type": "number",
          "description": "9 on a 9-result name match, 0 on a no-match search."
        }
      },
      "additionalProperties": true
    },
    "meta": {
      "type": "object",
      "properties": {
        "page": {
          "type": "number",
          "description": "Observed as 0 on both real captures."
        },
        "page_size": {
          "type": "number",
          "description": "Observed as 1 on both real captures."
        }
      },
      "additionalProperties": true
    },
    "message": {
      "type": "string",
      "description": "A human-readable status string. Only observed when the search matched zero locations (e.g. 'No locations found matching your search'); absent from the response entirely when at least one location is returned."
    },
    "success": {
      "type": "boolean",
      "description": "true on both a match and a no-match search."
    }
  },
  "description": "The search result.",
  "additionalProperties": true
}