What this connector is
UkraineBorder publishes a read-only MCP connector so AI assistants can answer questions about travelling to Ukraine using our editorial guides instead of relying on model recall.
- Endpoint:
https://www.ukraineborder.com/api/mcp - Transport: streamable HTTP
- Authentication: none — the connector is public and read-only
What it can do
| Tool | What it does |
|---|---|
| Search UkraineBorder | Finds guides on border crossings, customs, safety, visas and insurance across 10 languages |
| Fetch document | Returns the full text of a guide by the id returned from search |
| Search content (localized) | The same search, restricted to a single language |
| Get topic cluster summary | Overview of a section: what it covers and its key articles |
| Get insurance regulatory facts | Insurer, licence class, agent identity and the territorial exclusion categories |
| Estimate insurance price (indicative) | Approximate cost computed from published rates — not a quote, not an offer |
| Create prefilled checkout link | Builds a link to our checkout with the trip parameters filled in |
How to connect
The connector is a public, read-only MCP server. There is no account, no API key and no approval step. Every client below needs the same three facts:
- Endpoint:
https://www.ukraineborder.com/api/mcp - Transport: Streamable HTTP
- Authentication: none
Add to Microsoft Copilot Studio
- Open your agent and go to Tools.
- Select Add a tool, then New tool, then Model Context Protocol.
- Fill in the three required fields:
- Server name: UkraineBorder
- Server description: Ukraine entry rules, border crossings, customs, safety and war-risk travel insurance, in 10 languages.
- Server URL:
https://www.ukraineborder.com/api/mcp
- For authentication type select None, then select Create.
- Select Add to agent.
Two things are easy to miss. Copilot Studio requires generative orchestration to be turned on before an MCP server can be used at all. And it supports the Streamable transport only, which is what this connector serves. Copilot Studio consumes MCP tools and resources; the two prompt templates this server publishes are used by other clients and are simply ignored.
Add to Perplexity
Point a custom connector at the endpoint above; no key or approval is required. Adding your own MCP connector is a workspace-level capability rather than something available on every plan, so if the option is not present in your account, that is a plan question rather than a problem with this endpoint.
Add to Claude
- Open Settings, then Connectors.
- Select Add custom connector.
- Enter
https://www.ukraineborder.com/api/mcpas the endpoint and save.
Claude reads the tools, the two prompt templates and the curated insurance resources this server exposes.
Add to ChatGPT
UkraineBorder is listed in the ChatGPT Apps Directory, so no manual setup is needed. To add it by hand instead, use the same endpoint as a custom connector.
Example questions
- What documents does a US citizen need to enter Ukraine?
- Which Poland–Ukraine border crossings are open and what documents do I need there?
- Roughly what does war-risk travel insurance cost for two people for ten days?
Limits worth knowing
- Prices are indicative. The estimate is computed locally from published rates. It is not a partner quote and not a binding offer — the exact amount is calculated and charged during checkout on ukraineborder.com.
- The connector never sells anything. It has no write tools, takes no payment and issues no policy. Purchases are completed on our own site, where identity, email verification and payment happen.
- No personal data. It requires no login and receives no name, email, passport or payment details. See our Privacy Policy, section 2.6.
- Entry rules change. Every guide cites its official source and carries a review date. Verify time-critical details with the official source before you travel.
Known issues and limitations
- Search is keyword-based, not semantic. Matching runs over article titles and text. Short, concrete queries work better than long conversational ones. If a search returns nothing useful, try the topic word on its own, for example "customs" or "air alerts".
- Two search tools exist, and they differ.
searchtakes a query only and infers the language from the script you typed in; it exists for clients whose schema is fixed, such as ChatGPT deep research.search_contenttakes an explicit locale and returns richer results. Prefersearch_contentwhen your client can pass arguments freely. - Documents published in the last 24 hours are invisible. New articles are held under editorial review before they are indexed, and the connector honours that hold. A guide you can see on the website may not yet be searchable here.
- Estimates are computed locally and are not partner quotes.
estimate_quoteapplies published rates. It does not contact the insurer, so it cannot reflect underwriting decisions, and the amount charged at checkout may differ. - Amounts are returned in euro only. The payment provider converts at its own rate at the time of payment.
- Territorial coverage is described as zone categories, never as whole regions. The excluded areas are defined by government acts plus a 50 km buffer and change over time, so the connector will not list specific towns. Use the official register for a definitive answer.
- Resources are published per language as they clear legal review. Curated insurance resources are currently served for English and Ukrainian, so
resources/listmay be shorter than the full ten-language set. - Rate limiting is per IP and best effort. Bursts may receive JSON-RPC error
-32029. Retry after a short pause. - Tool errors are returned as content, not as protocol failures. If a tool cannot answer, the result carries
isErrorwith a plain-text reason rather than breaking the session. Clients should surface that text instead of retrying blindly. - There is no server-initiated stream. The transport is stateless: every exchange is a single
POST, and there are no sessions and no notifications.
Support
Questions about the connector: info@welcomeukraine.today — operated by Welcome Ukraine (USREOU 44559356).