Bridgeo Agent API and MCP server for cross-border money transfers

Bridgeo is a planner, not a bank, transfer provider or adviser. This API gives your app or agent the same reviewed corridor data that powers bridgeofin.app: routes ranked by total landed cost and speed, rules with sources, documents, bank closures, rate trends and a grounded assistant. Fees are indicative averages, not live quotes, and every response says so.

Get a key

Keys are issued by hand while we onboard the first partners. Email partner@bridgeofin.app with who you are and what you are building. Each key has a daily request quota and a daily quota for the assistant endpoint; both are visible at GET /v1/usage.

REST

Send the key as Authorization: Bearer bk_live_.... Base URL: https://w6fvxlmllh.execute-api.ap-south-1.amazonaws.com. Full description: openapi.json.

curl -s -X POST https://w6fvxlmllh.execute-api.ap-south-1.amazonaws.com/v1/plan   -H "Authorization: Bearer $BRIDGEO_KEY" -H "content-type: application/json"   -d '{"corridor":"US>IN","goal":"education","amount":5000}'

Endpoints

GET /v1/corridors corridors, goals, speeds
GET /v1/corridors/{id} reviewed facts for one corridor
POST /v1/plan routes, rules, documents, journey
POST /v1/recipient/check offline format check (IFSC, UPI, IBAN, CLABE, ABA, UK sort code)
POST /v1/closures weekends and bank holidays on both sides
POST /v1/trend today's rate against recent days (past data, not a forecast)
POST /v1/ask question answered only from reviewed facts
GET /v1/usage today's usage and caps

MCP (for AI agents)

A remote MCP server speaks JSON-RPC over HTTP at https://w6fvxlmllh.execute-api.ap-south-1.amazonaws.com/mcp with the same bearer key. Tools: list_corridors, get_corridor_facts, plan_transfer, check_recipient_detail, bank_closures, rate_trend, ask_assistant. Example client configuration:

{
  "mcpServers": {
    "bridgeo": {
      "type": "http",
      "url": "https://w6fvxlmllh.execute-api.ap-south-1.amazonaws.com/mcp",
      "headers": { "Authorization": "Bearer bk_live_YOUR_KEY" }
    }
  }
}

How it behaves

Read-only. It never moves money, never takes card, bank or ID details, and stores nothing you send except anonymous usage counts per key.
The assistant answers only from Bridgeo's reviewed facts, refuses other topics, blocks sensitive data and prompt-injection attempts, and never returns links.
Responses include the review date of the rules, the source of each rule where we have one, and whether a holiday list is complete. Treat gaps as gaps.
Rate limits: x-ratelimit-limit and x-ratelimit-remaining headers on every response; 429 when a quota is used up.

Terms in short

Use the data to inform people, not to give personalised tax, legal or investment advice. Show the disclaimer returned with the data. Do not present indicative fees as quotes. We may change or withdraw a key if it is misused. Questions: partner@bridgeofin.app.

Informational only. Privacy · Back to the planner