Developers

BudgetBro developer & AI agent resources

BudgetBro is a travel budgeting app for backpackers and digital nomads. This page lists the public, unauthenticated ways to read BudgetBro content programmatically, and how AI assistants connect to a user's own data over the Model Context Protocol. No API key is required for the read-only content endpoints below.

Machine-readable resources

OpenAPI specification · /openapi.json
Machine-readable description of every public REST endpoint (OpenAPI 3.1). Feed this to an LLM to enable function calling.
AI facts endpoint · /api/ai
Structured JSON profile: pricing, features, platforms, competitor comparison and a full article index.
llms.txt · /llms.txt
Curated company profile plus a live index of every published article (llmstxt.org convention).
llms-full.txt · /llms-full.txt
The full knowledge base in one file for retrieval and grounding.
MCP manifest · /.well-known/mcp
Discovery manifest for the BudgetBro MCP server.
Sitemap · /sitemap.xml
Every canonical URL on the site.
RSS feed · /feed.xml
Latest published articles as RSS.

Public REST API

Read-only JSON over HTTPS. Base URL https://budgetbro.app. Responses are edge-cached. The full contract, including response schemas, is 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 content negotiation

Every article is available as Markdown. Append .md to any article URL, or request the HTML 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 (MCP)

The first-party budgetbro-mcp server exposes a connected user's expenses, budgets, subscriptions and trips to AI assistants like Claude and ChatGPT, and can log expenses in natural language. Create a connection token in BudgetBro Web settings, then add this to your MCP client config. See 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.