Bridge Town
officialBridge Town is an MCP-native, git-versioned financial modeling platform for FP&A teams and finance leaders. AI agents use Bridge Town tools to create projects, write Python model files, run models in isolated cloud sandboxes, query data, write outputs to Google Sheets, create dashboards, branch scenarios, and collaborate with teammates.
What can you do with Bridge Town MCP?
- Discover the right tool — Ask your assistant to call
search_toolsto find the correct current MCP tool for a financial modeling goal. - Inspect tool schemas — Use
get_toolto retrieve the full schema of any tool before invoking it. - Preserve sheet states — Run
native_sheet_reader.pyin a model repo to read Native Sheets while keeping missing, blank, and formula states intact. - Track output dependencies — Generate validated
output_lineage.jsondependency graphs withoutput_lineage.pyfor model outputs. - Connect via stdio — Forward MCP calls to the hosted endpoint using the local stdio shim with a Bridge Town API token.
Documentation
Bridge Town MCP Connector
Build financial models as code with cloud execution, Native Sheets, Google Sheets, version control, and collaboration.
This public repository contains documentation, registry metadata, a minimal stdio-to-HTTP shim, and versioned model-authoring helpers for the hosted Bridge Town MCP connector. The commercial server implementation is operated by Bridge Town and is not published here.
- Website: https://www.bridgetown.builders
- App: https://app.bridgetown.builders
- Documentation: https://www.bridgetown.builders/docs/
- MCP endpoint:
https://api.bridgetown.builders/mcp - Transport: MCP Streamable HTTP
- Authentication: OAuth for hosted connector flows; bearer tokens for manual client configuration
Bridge Town does not run a server-side LLM or proxy prompts. The user's chosen AI client and model provider run the conversation; Bridge Town receives typed MCP calls and executes deterministic platform operations.
Connect
For Claude.ai, add https://api.bridgetown.builders/mcp as a custom connector
and approve the Bridge Town OAuth prompt.
For clients that support Streamable HTTP plus headers:
{
"mcpServers": {
"bridge-town": {
"transport": {
"type": "http",
"url": "https://api.bridgetown.builders/mcp",
"headers": {
"Authorization": "Bearer btk_YOUR_TOKEN"
}
}
}
}
}
Generate and revoke API tokens at https://app.bridgetown.builders/connect. See Getting Started for setup, current task flows, and troubleshooting.
Canonical MCP surface
The production endpoint exposes one canonical tool catalog. Use search_tools
to find the correct current tool for a goal and get_tool to retrieve its full
schema. The catalog does not change based on the client or user agent.
The canonical registry manifest for this public listing is server.json. It points to the hosted remote MCP server; it is not a copy of the proprietary server implementation.
Versioned model-authoring helpers
Small helper modules that are intended to run inside a model repository are published as immutable, MIT-licensed releases:
native_sheet_reader.pyv1.1.0 preserves Native Sheet missing/blank/formula states and emits bounded, value-free read identities.output_lineage.pyv1.1.0 emits validatedoutput_lineage.jsondependency graphs.
The v1.1.0 release directory includes
runnable examples, a changelog, ownership, license, manifest, and
SHA256SUMS. Install a helper byte-for-byte at the manifest's target_path
and verify its digest before committing it to a model repository.
Local stdio shim
Most clients should connect directly to the Streamable HTTP endpoint. A local MCP host that requires stdio may use the minimal forwarding shim:
BRIDGE_TOWN_API_TOKEN=btk_YOUR_TOKEN npx github:Bridge-Town/financial-modeling-mcp
The shim does not read or write local files or spawn child processes. It only forwards MCP JSON-RPC messages over HTTPS to the configured Bridge Town MCP endpoint.
Security
Financial model execution runs in an isolated container without outbound
network access. Google access uses drive.file, limiting Bridge Town to files
selected through the Bridge Town flow or created by Bridge Town.
Report vulnerabilities privately through SECURITY.md. Do not open a public issue or include customer data in a report.
Governance
- Support
- Contributing and contribution boundary
- Public and private source boundary
- Ownership
- MIT license
The governance files are generated from the closed, versioned
directory-resources.v1.json metadata contract.