Skip to main content

Developers

Build on BudgetBro.

BudgetBro is a travel budgeting app for backpackers and digital nomads. This page lists the public ways to read BudgetBro content in code, and how AI assistants connect to a user's own data over the Model Context Protocol (MCP). The read-only content endpoints need no API key.

Machine-readable files

Public REST API

Read-only JSON over HTTPS. Base URL https://budgetbro.app. Responses are cached at the edge. Response schemas are in the OpenAPI specification.

GET/api/ai

Structured product facts for AI grounding (no parameters).

curl https://budgetbro.app/api/ai

GET/api/blog/posts

Paginated list of published BudgetBro articles.

  • page 1-based page number (default 1).
  • limit Posts per page, 1-100 (default 12).
  • category Filter by category slug, e.g. guides.
  • tag Filter by tag slug.
  • recent true to only return posts from the last 30 days.
  • recentDays Override the recency window in days.
curl "https://budgetbro.app/api/blog/posts?category=guides&limit=5"

GET/api/blog/feed

Merged recent feed: BudgetBro posts interleaved with curated third-party link-outs (each item has a type of post or external).

  • limit Max items, 1-50 (default 20).
  • recentDays Recency window for our posts (default 30).
curl "https://budgetbro.app/api/blog/feed?limit=20"

GET/api/blog/around-the-web

Curated third-party travel articles (excerpt + source + outbound link).

  • limit Max items, 1-50 (default 20).
curl "https://budgetbro.app/api/blog/around-the-web?limit=10"

GET/blog/{slug}.md

A single published article as Markdown, for retrieval and grounding.

curl https://budgetbro.app/blog/dtvvisaguidethailand.md

Markdown versions

Every article is available as Markdown. Add .md to any article URL, or request the normal URL with an Accept: text/markdown header. The homepage responds to the same header. Responses set Vary: Accept.

curl -H "Accept: text/markdown" https://budgetbro.app/blog/dtvvisaguidethailand

Connect an AI assistant

Our budgetbro-mcp server gives AI assistants such as Claude and ChatGPT access to a connected user's expenses, budgets, subscriptions and trips, and can log expenses from a plain-English message. Create a connection token in BudgetBro Web settings , then add the snippet below to your MCP client config. More in the MCP overview and the discovery manifest.

{ "mcpServers": { "budgetbro": { "command": "npx", "args": ["-y", "budgetbro-mcp"], "env": { "BBRO_CONNECTION_TOKEN": "<your token>" } } } }

Contact

Questions, or want to build on BudgetBro? Email support@budgetbro.app.