Close API

city.closePublished by close.cityOfficial publisherv1.2.0Updated Oct 24, 2026

Walk, bike, and transit travel times from every US census block to nearby amenities.

VerifiedStreamable HTTPWeb executableLocation & LifestyleData & Analytics

Overview

AI-generated overview

Remote MCP server for US walk, bike and transit travel times from census blocks to nearby amenities, with metered token billing.

What you can do
  • Look up US cities and towns by name and get their census place GEOID and centre point
  • List travel modes and destination-type taxonomy to resolve type ids
  • Compute travel times from one or many origins to destination categories, or to nearby points of interest
  • Draw reachable-area isochrones as GeoJSON contours
  • Get per-block travel times for every census block in a city or radius
  • Check token balance, start email sign-up, redeem a code for an API key, and get a Stripe checkout link for the paid membership
When to use it
Useful for questions about how walkable, bikeable or transit-connected a US location is, comparing neighbourhoods or blocks, or producing reachability data and isochrones for analysis or mapping.
Requirements
Remote streamable HTTP endpoint at mcp.close.city; no local install. Free tools work without a key; metered tools need an Authorization bearer API key from an account, obtained through the email sign-up tools. The user must read a six-digit code from their own inbox.
Before you install
Metered tools spend tokens per returned row or contour, so large batches, big limits and extra contours cost more; check the balance first. The API key is shown once and must be stored and passed as the Authorization bearer. Sign-up and membership involve the user's email and a Stripe payment page; the user should complete payment in their own browser.

Installation

In SourceWeft

  1. Open Close API in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/city.close%2Fclose-api/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "close-api": {
      "type": "http",
      "url": "https://mcp.close.city/mcp"
    }
  }
}

README

This repository has no README.

Tools

10

find_place

Look up a US city or town by name (free, no key). Returns matches with their census place GEOID and centre point (lon/lat). The entry point: feed a GEOID to blocks_in_area, or a centre to walkability_summary.

Parameterslimitqueryrequired

get_catalog

List the travel modes and the destination-type taxonomy (free, no key). Use it to resolve type names to the numeric ids the other tools take. Modes are walk, bike, transit — there is no drive mode.

Takes no parameters.

walkability_summary

Fastest travel time from a location to each destination category, by mode (metered: 1 token per returned row). One origin: block_geoid or lat+lon. Many origins (up to 250): block_geoids or points — one batch call and one rate-limit request, with rows tagged by origin. Batching saves requests and context, not tokens: it still charges per row. A non-empty truncated (+ truncated_reason) means the balance or row budget cut the batch short. A missing category means it is not reachable within 30 minutes.

Parameterslatlonmodepointsblock_geoidblock_geoids

nearby_pois

Nearby points of interest and the travel time to each, from a location (metered: 1 token per returned row). One origin: block_geoid or lat+lon; keep limit small to control spend and context size. Many origins (up to 250): block_geoids or points — one batch call and one rate-limit request, rows tagged by origin, no limit/pagination, so filter with type/mode/max_minutes. Batching saves requests and context, not tokens: it still charges per row. A non-empty truncated (+ truncated_reason) means the balance or row budget cut the batch short.

Parameterslatlonmodetypelimitpointsblock_geoidmax_minutesblock_geoids

isochrone

The area reachable from a location within a time budget, as GeoJSON contours (metered: 10 tokens per contour). Give block_geoid or lat+lon. Defaults to a single 30-minute contour; ask for more only when needed (bodies can be large).

Parameterslatlonmodeminutescontoursdirectionblock_geoid

blocks_in_area

Per-block travel times for every census block in an area (metered: 1 token per returned row). Give place_geoid (from find_place) for a whole city, or center {lat, lon} + radius_m. Rows carry a numeric mode_id.

Parameterslatlonmodetypelimitradius_mplace_geoid

get_token_balance

Check the token balance of the API key in use, without spending any tokens. Works even at a zero balance. Requires the Authorization bearer key.

Takes no parameters.

request_sign_in

Start free sign-up for the user: email them a six-digit code. The user must read the code from their own inbox and give it to you, then call redeem_code. This is how an agent gets the user an API key (5,000 free tokens, no card).

Parametersemailrequired

redeem_code

Complete sign-up with the six-digit code the user received, and return a new API key (shown once). Call request_sign_in first. The key grants 5,000 free tokens; store it and pass it as the Authorization bearer on future calls.

Parameterscoderequiredemailrequiredlabel

join_close_plus

Get a Stripe Checkout URL for the Close+ membership ($10/month: 5,000 API tokens granted monthly plus member features on the close.city map). The user pays in their own browser: give them the returned URL and stop. Needs a fresh six-digit code from request_sign_in, read by the user from their own inbox.

Parameterscoderequiredemailrequired

Version history

1
  1. v1.2.0LatestSep 16, 2026

Score

75% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • License10 pts

    Declare a license in the repository or the registry entry.

Other Close integrations