developer-toolsapi_key

Geocodio

Geocodio provides straightforward and easy-to-use geocoding, reverse geocoding, and data matching services for US and Canadian addresses.

Verdict

Geocodio turns addresses into coordinates and enriches them with boundary data — congressional districts, school zones, census tracts, timezones, and Canadian electoral ridings. @mention it in a Space to geocode customer lists, append legislative districts to voter files, or validate addresses before mailing. Sales ops, civic tech teams, and anyone building location-aware workflows get the most use. You'll need a Geocodio API key; free tier covers light usage, but bulk operations require a paid plan.

Common use cases

  • Geocode customer addresses for territory mapping
  • Append school districts to enrollment lists
  • Validate mailing addresses before print runs
  • Enrich voter files with legislative districts
  • Add timezones to event attendee records

Integration

Vendor
Geocodio
Category
developer-tools
Auth
API_KEY
Tools
14
Composio slug
geocodio

Tools

  • Append Canadian Provincial Electoral District

    Tool to append Canadian provincial electoral district to geocode results. Use when you need the provincial riding for a Canadian address.

  • Append Canadian StatCan Boundaries

    Tool to append Canadian statistical boundaries from Statistics Canada. Use after geocoding addresses to enrich results with StatCan geography data.

  • Append Census Data to Geocoded Address

    Tool to append Census block/tract FIPS and MSA/CSA codes to geocoded addresses. Use when you need detailed Census boundaries and metropolitan area codes.

  • Append Congressional District

    Tool to append Congressional District information to a geocoded address. Use after confirming address validity.

  • Append FFIEC Fair Lending Data

    Tool to append FFIEC (Fair Lending) data to a geocoded address. Use after validating address input for detailed lending and demographic metrics.

  • Append School District

    Tool to append School District information to a geocoded address. Use after confirming address validity for K12 district boundaries.

  • Append State Legislative District

    Tool to append state legislative district information to a geocoded address. Use after confirming the address validity.

  • Append Timezone

    Tool to append timezone information to geocode results. Use when you need local timezone details for a given address.

  • Batch Reverse Geocode

    Tool to batch reverse geocode up to 10,000 coordinates in one request. Use when you need addresses for many lat/lon pairs.

  • Delete Geocodio List
    destructive

    Tool to delete a specific list. Use when you need to permanently remove an existing list after confirming its list_id.

  • Get Coordinates for Batch Reverse Geocode

    Tool to provide a predefined set of latitude,longitude strings. Use when testing batch reverse geocoding without calling external APIs.

  • Single Forward Geocode

    Tool to forward geocode a single address. Use when you need coordinates and metadata for one address.

  • Single Reverse Geocode

    Tool to reverse geocode a single coordinate. Use when you need to convert one lat,lng to an address.

  • USPS ZIP+4 Append

    Tool to append USPS ZIP+4 information to US addresses. Use when detailed ZIP+4 data is required.

Setup

Setup guide

  1. 11. Open your Switchy workspace and navigate to Settings → Integrations → Developer Tools. 2. Click 'Connect' next to Geocodio. 3. Log into your Geocodio account at geocod.io and go to API Keys in the dashboard. 4. Copy your API key (create one if you don't have it). 5. Paste the key into Switchy's connection dialog and click 'Authorize'. 6. Return to any Space and type '@Geocodio geocode 1600 Pennsylvania Ave NW, Washington DC' to test the connection. 7. If the response includes latitude, longitude, and accuracy score, the integration is live. 8. Use @Geocodio followed by your task to invoke tools — specify which append you need (census, district, timezone) in your prompt.

What teammates see: by default, memories from Geocodio are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.

Works well with

Top models

Compatibility data appears once enough Spaces have used this MCP together with a given model.

How Switchy teams use it

Not enough Spaces yet to publish anonymised usage stats (we require ≥ 50 Spaces per week).

Starter prompts

Geocode Address List

@Geocodio geocode these addresses and return the coordinates with accuracy scores: 123 Main St, Austin TX; 456 Oak Ave, Portland OR; 789 Elm Blvd, Miami FL
Open in a Space →

Append Congressional Districts

@Geocodio geocode 1600 Pennsylvania Ave NW, Washington DC 20500 and append the congressional district information
Open in a Space →

Enrich With Census Data

@Geocodio geocode 350 Fifth Avenue, New York NY 10118 and append census block, tract, and MSA codes
Open in a Space →

Find School Districts

@Geocodio geocode 742 Evergreen Terrace, Springfield and append the unified and elementary school district information
Open in a Space →

Add Timezone to Locations

@Geocodio geocode these addresses and append timezone data: 1 Market St, San Francisco CA; 233 S Wacker Dr, Chicago IL
Open in a Space →

Example outputs

Illustrative - representative of the model's voice and quality, not literal recordings.

Prompt

@Geocodio what timezone and congressional district is 1600 Pennsylvania Avenue NW, Washington DC in?

Output

Based on Geocodio's geocoding and appended data, 1600 Pennsylvania Avenue NW is in the America/New_York timezone (UTC-5/UTC-4 during DST) and falls within Congressional District DC-00 (District of Columbia's at-large district). The address geocodes to coordinates 38.8977, -77.0365 with rooftop-level accuracy. This example illustrates how Geocodio can enrich a single address lookup with multiple political and temporal boundary layers in one API call.

Notes

This example combines geocoding with two append operations (timezone and congressional district). Geocodio charges per lookup plus per append field, so requesting multiple enrichments increases API cost. The congressional district data reflects current boundaries; redistricting after the 2030 Census will change these values. Requires a valid API key with sufficient quota.

Prompt

@Geocodio I have a CSV with 500 Canadian addresses in Toronto—append the provincial electoral districts and StatCan boundaries to each row.

Output

Geocodio would process the batch upload (up to 10,000 addresses per file) and return a CSV with original columns plus appended fields: provincial riding name and code (e.g., Toronto—St. Paul's, 35088) and Statistics Canada boundaries including census subdivision, census tract, and dissemination area codes. Processing 500 addresses with two append operations would consume 1,500 API credits (500 geocodes + 1,000 appends). This example shows Geocodio's batch processing capability for Canadian civic geography, useful for canvassing or demographic analysis.

Notes

Batch geocoding is more efficient than individual API calls but requires CSV formatting (address components in separate columns or single 'address' field). Canadian append fields are separate products from US fields. Results depend on address quality—ambiguous or incomplete addresses may return lower accuracy scores or multiple candidates. Review the accuracy_score field in results to identify addresses needing manual verification.

Prompt

@Geocodio compare the school districts and Census tract demographics for these three addresses, then recommend which location has the highest-rated elementary schools in lower-income areas.

Output

After geocoding the three addresses, Geocodio returns school district boundaries (unified, elementary, and secondary district names and codes) plus Census tract FIPS codes and MSA/CSA identifiers. However, Geocodio does not provide school ratings or socioeconomic analysis—it returns boundary identifiers only. To answer the recommendation question, you would need to cross-reference the returned school district codes with a ratings database (like GreatSchools API) and the Census tract codes with ACS income data. This example demonstrates that Geocodio excels at boundary identification but requires pairing with other data sources for evaluative analysis.

Notes

This illustrates an important limitation: Geocodio appends geographic identifiers (district codes, FIPS codes) but not the qualitative data those identifiers unlock. The AI can reason about next steps (which APIs to query with the returned codes) but cannot complete the analysis using Geocodio alone. The Census append returns codes, not demographics—actual income or population data requires a separate Census API call. Plan for multi-step workflows when enrichment needs go beyond boundary assignment.

Use-case deep-dives

Real estate CRM address enrichment

When Geocodio beats building your own address pipeline

A 6-person proptech startup needs to enrich 2,000 inbound leads per month with school districts, Census tracts, and timezone data for their CRM. Geocodio wins here because the 14 append tools cover the exact boundaries real estate teams query—no need to stitch together TIGER/Line shapefiles and maintain geocoding infrastructure. The API key auth means any agent can call it without OAuth handshakes. The trade-off: if you're processing 100k+ addresses daily, the per-lookup cost adds up and you might justify running your own PostGIS stack. For teams under 50k lookups per month who need US/Canada boundary data fast, Geocodio is the right call. Connect it to your CRM webhook and let agents answer "what school district?" questions in real time.

Nonprofit grant compliance reporting

Geocodio for legislative district lookups at scale

A 3-person nonprofit operations team files quarterly reports that require congressional and state legislative districts for 800 beneficiary addresses. Geocodio's append tools—Congressional District, State Legislative District, Canadian Provincial Electoral District—are purpose-built for this. The team runs a batch job once per quarter, feeds addresses through the MCP, and exports enriched CSVs for their grant portal. No GIS expertise required. The boundary: if your reporting needs custom catchment areas or non-electoral geographies (watershed districts, custom service zones), Geocodio won't have those shapefiles and you'll need a spatial database. For standard legislative and Census boundaries in the US and Canada, this MCP eliminates the need to hire a GIS consultant or learn QGIS. Wire it into your quarterly workflow and ship compliant reports on time.

Customer support timezone routing

When Geocodio's timezone append solves ticket assignment

A 12-person SaaS support team routes inbound tickets to agents based on customer timezone to keep response times under 2 hours during business hours. They geocode the billing address on file and append timezone data using Geocodio's Append Timezone tool. The MCP returns IANA timezone strings that feed directly into their ticket assignment logic. The win: no need to maintain a separate timezone lookup service or guess from area codes. The constraint: if your customer base is heavily international beyond North America, Geocodio's coverage thins out and you'll need a global geocoder like Google Maps. For US and Canadian customers, this MCP is the fastest path from address to timezone. Plug it into your ticket intake flow and let agents focus on answers, not clock math.

Frequently asked

What does the Geocodio MCP do in Switchy?

It turns addresses into latitude/longitude coordinates and enriches them with boundary data — Congressional districts, school districts, Census tracts, timezones, and Canadian electoral ridings. You ask the AI to geocode an address or append demographic data, and it calls Geocodio's API through the MCP. Useful for teams building location features, analyzing service areas, or enriching CRM records with district information.

Do I need a paid Geocodio account to use this MCP?

Yes. You need a Geocodio API key, which requires signing up at geocod.io. Geocodio offers a free tier with 2,500 lookups per day; after that you pay per lookup. The MCP connects using that API key — no OAuth flow. Whoever sets up the integration in Switchy needs access to the Geocodio dashboard to generate the key.

Can it reverse-geocode coordinates into street addresses?

Yes. Geocodio supports reverse geocoding — you give it a lat/long pair and it returns the nearest street address. The MCP exposes this through tools the AI can call. It works for US and Canadian coordinates. Accuracy depends on Geocodio's underlying data; rural areas may return approximate matches rather than exact house numbers.

How does this compare to using Google Maps API directly?

Geocodio is cheaper and purpose-built for US/Canadian address data with political boundaries baked in. Google Maps covers the world but charges more and doesn't natively return Congressional districts or Census tracts. If you only need lat/long for addresses outside North America, use Google. If you're appending legislative districts or FFIEC data to US addresses, Geocodio is faster and costs less per lookup.

Does each geocode lookup count against my Switchy plan?

No. Geocodio lookups count against your Geocodio account limits, not Switchy's. Switchy routes the MCP calls to Geocodio's API using your key. If you hit Geocodio's daily free tier cap or run out of prepaid credits, the MCP will return errors until you upgrade your Geocodio plan. Switchy doesn't meter or throttle the calls.

Data last verified 607 hours ago.Sources aggregated hourly to weekly. See docs/architecture/model-directory.md.