Azure Maps Search (BYOK)

Azure Maps Search (BYOK) — connector documentation

• MCP endpoint: https://byok-azure-maps-search.connectorbay.com/mcp
• REST API: POST https://byok-azure-maps-search.connectorbay.com/v1/tools/{tool_name}, described by the OpenAPI 3.1 spec at https://byok-azure-maps-search.connectorbay.com/openapi.json
• Transport: Streamable HTTP, stateless, MCP specification 2025-06-18 or later
• Authentication: your own Azure Maps Search Azure Maps account subscription key (primary or secondary), sent in the X-Upstream-Key header of every request (never stored, logged or cached)
• Health: https://byok-azure-maps-search.connectorbay.com/health · Tool schemas: https://byok-azure-maps-search.connectorbay.com/tools.json
• Publisher: Unify Dynamics LLC · connectorbay.com/byok-azure-maps-search · agent@connectorbay.com

What Azure Maps Search (BYOK) is for

Azure Maps Search (BYOK) lets an AI assistant read your own Azure Maps Search data through the Azure Maps Search API with a key you supply (Azure Maps account subscription key (primary or secondary)). Read-only: 9 tools (search_fuzzy, search_poi, search_nearby, search_poi_category, list_poi_category_tree, search_address, search_structured_address, reverse_geocode, reverse_cross_street). The BYOK key travels with each request, is used for that one call only and is never stored, logged or cached; it is only ever sent to atlas.microsoft.com. Unofficial connector by Unify Dynamics LLC: not affiliated with, endorsed by or sponsored by Azure Maps Search. Azure Maps Search and its logos are trademarks of their owners and are used only to say which service the connector works with.

Ask your assistant things like:

• "Find coffee shops near downtown Seattle"
• "Where is the nearest Starbucks to downtown Seattle?"
• "What points of interest are within 1 km of 47.6062,-122.3321?"
• "List airports near Seattle"
• "Which POI categories does Azure Maps support?"
• "What are the coordinates of 1 Microsoft Way, Redmond, WA?"

What it does

• search_fuzzy: Free-form search that accepts addresses, places, points of interest or coordinates in one query, with optional location bias and filters. Returns type, score, name, address and position.
• search_poi: Search points of interest by name or brand, such as 'statue of liberty' or 'starbucks', optionally biased toward a position.
• search_nearby: List points of interest around a coordinate within a radius, optionally for given category ids. Needs a latitude and longitude.
• search_poi_category: Search points of interest of one category word, such as RESTAURANT or AIRPORT, optionally near a position.
• list_poi_category_tree: List the supported POI categories with id, name, child category ids and synonyms, for use as category filters.
• search_address: Geocode a street address or a place name to coordinates, with the formatted address and match score.
• search_structured_address: Geocode an address given as separate parts (street, city, postal code, country code) instead of one string.
• reverse_geocode: Convert a coordinate to the nearest street address, with locality, postal code, country and optionally road use.
• reverse_cross_street: Find the nearest cross street for a coordinate, useful to describe an intersection.

BYOK key

You bring your own Azure Maps Search Azure Maps account subscription key (primary or secondary) (https://learn.microsoft.com/en-us/azure/azure-maps/how-to-manage-account-keys). Your assistant sends it in the X-Upstream-Key header with each request. ConnectorBay uses it for that one call only: it is never stored, logged or cached, never shown in an answer, and it is only sent to atlas.microsoft.com over https, with no redirects followed. Create a key with the fewest permissions the tools need (read-only if the provider offers it), and revoke it at the provider whenever you like.

Data sources

• https://learn.microsoft.com/en-us/rest/api/maps/search?view=rest-maps-1.0 (the API this connector calls, with a BYOK key)

Live from the Azure Maps Search API (atlas.microsoft.com) with a BYOK key; documentation: https://learn.microsoft.com/en-us/rest/api/maps/search?view=rest-maps-1.0. Endpoints checked against that documentation on 2026-10-16.

What it is not

Unofficial connector by Unify Dynamics LLC: not affiliated with, endorsed by or sponsored by Azure Maps Search. Azure Maps Search and its logos are trademarks of their owners and are used only to say which service the connector works with. It is read-only: it never creates, changes, sends or deletes anything in your Azure Maps Search account.

Built for: Worldwide. Languages: English.

Azure Maps Search (BYOK) — Privacy Policy

Effective 16 October 2026. Unify Dynamics LLC ("we", "us"), Menlo Park, California.

What Azure Maps Search (BYOK) is. Azure Maps Search (BYOK) is a connector (an MCP server and REST API) that an AI assistant calls on your behalf to read your own Azure Maps Search data: Search places, points of interest and addresses, reverse geocode coordinates and read the POI category tree with your own Azure Maps subscription key. You bring your own Azure Maps Search Azure Maps account subscription key (primary or secondary); the assistant sends it to us with each request.

BYOK key. The key you supply is used to make the one Azure Maps Search call you asked for. Our application does not store it, write it to a log, put it in a cache, or share it. It is sent only to atlas.microsoft.com, over https, and is removed from any text we return to you or your assistant. We do not follow redirects with your key. If Azure Maps Search rejects it, we say so without repeating it.

What we receive. The arguments of each tool call, the BYOK key (for that call only), the technical headers needed to serve the request (an IP address or a client identifier supplied by the assistant) and standard server logs. What Azure Maps Search receives. The request we make on your behalf, including the key and the arguments, under Azure Maps Search's own terms and privacy policy (https://azure.microsoft.com/en-us/support/legal/). Azure Maps Search acts at your direction and is the only recipient of the data of your request besides our hosting provider.

What we return. The answer Azure Maps Search gives for your request, trimmed to the fields the tool documents. We do not keep it: it is returned to your assistant and not stored, cached or used to train anything.

What we do not do. We do not build a profile, sell or share personal information, or keep your Azure Maps Search data. Rate-limit counters (a client identifier and timestamps) are held in memory for at most 24 hours. Hosting access logs (IP addresses, request paths and status codes) are kept for up to 30 days for security and abuse prevention; our application adds no request headers or bodies to them.

Sub-processors. Azure Maps Search (the API you call with a BYOK key, at your direction). Hosting: Vercel (United States regions).

Your rights. Because we store no personal data beyond short-lived logs, requests to access, correct or delete data are usually satisfied automatically; you can still contact agent@connectorbay.com and we will respond within 30 days. Revoke your key at Azure Maps Search at any time to end all access.

Children. Azure Maps Search (BYOK) is a general-audience service operated by the adult using the assistant, under Azure Maps Search's own age rules.

Changes. We will post changes here with a new effective date.

Azure Maps Search (BYOK) — Terms of Service

Effective 16 October 2026. These terms govern use of the Azure Maps Search (BYOK) connector ("the Service") operated by Unify Dynamics LLC ("we", "us").

1. The Service. Azure Maps Search (BYOK) provides: Search places, points of interest and addresses, reverse geocode coordinates and read the POI category tree with your own Azure Maps subscription key. It is accessed through an AI assistant or directly over MCP or HTTP, and is read-only.
2. Your own key, your own account. You must use your own Azure Maps Search credentials and only access data you are allowed to access. Azure Maps Search's terms (https://azure.microsoft.com/en-us/support/legal/) apply to your use of Azure Maps Search; you are responsible for complying with them, including any rate limits and permitted uses. Do not share a key you do not own.
3. Independent. Unofficial connector by Unify Dynamics LLC: not affiliated with, endorsed by or sponsored by Azure Maps Search. Azure Maps Search and its logos are trademarks of their owners and are used only to say which service the connector works with.
4. No advice, no guarantees. Output is the data Azure Maps Search returns, lightly trimmed; it may be incomplete, delayed or changed by Azure Maps Search. Check important facts at the source.
5. Read-only. The Service does not create, change, send or delete anything in your Azure Maps Search account.
6. Acceptable use. Automated use within the published rate limits is welcome. Do not use the Service to access data you are not entitled to, to circumvent Azure Maps Search's controls, or to attack any system.
7. Availability. The Service is provided "as is" without warranty. We may change, limit or discontinue it at any time; Azure Maps Search may change or end its API at any time.
8. Data. Our Privacy Policy describes what we process. In short: the BYOK key is used for the one call and not stored or logged.
9. Pro keys. Optional ConnectorBay Pro API keys are issued at our discretion and are separate from your Azure Maps Search key.
10. Liability. To the fullest extent permitted by law, Unify Dynamics LLC is not liable for any loss arising from use of or reliance on the Service, including any action Azure Maps Search takes on your account. Our total liability is limited to US $100.
11. Governing law. California law; venue in San Mateo County, California.
12. Contact. Unify Dynamics LLC · agent@connectorbay.com · https://connectorbay.com/byok-azure-maps-search

Azure Maps Search (BYOK) support

Email agent@connectorbay.com. We answer within two business days.

• MCP endpoint: https://byok-azure-maps-search.connectorbay.com/mcp
• REST API: https://byok-azure-maps-search.connectorbay.com/openapi.json
• Live status: https://byok-azure-maps-search.connectorbay.com/health

When you report a problem, include the question you asked your agent, roughly when, and which agent you used (for example Claude, ChatGPT or Gemini). Never send us passwords, account numbers or ID numbers. Azure Maps Search (BYOK) never asks for them.