# Railz MCP

> Railz MCP connects your AI agent to normalized financial data from every major accounting, banking, and commerce source. You can instantly audit invoices, generate P&L reports, or track cash flow across multiple client accounts without ever opening a dashboard. It turns complex bookkeeping into natural conversation.

## Overview
- **Category:** money-moves
- **Price:** Free
- **Tags:** financial-data, accounting-api, banking-integration, data-normalization, financial-reporting, audit-automation

## Description

Dealing with finance means juggling dashboards for QuickBooks, Xero, Shopify, and your bank feed—it's a nightmare of copy-pasting and tabs. Railz changes that. By connecting this MCP to your agent, you give it access to normalized financial data from various accounting, banking, and commerce platforms. Your agent acts like an expert analyst, allowing you to ask questions instead of navigating menus. You can instantly list all registered businesses or run a full Profit & Loss report without manual exports. Everything is structured and ready for conversation. Through Vinkius, your AI client gets immediate access to this whole suite of financial tools. It's not just data retrieval; it’s getting actionable insights from complex systems in plain language.

## Tools

### get_balance_sheet
Retrieves a structured balance sheet report for a specific business period.

### list_bank_transactions
Pulls and lists recent bank transactions associated with a connected account.

### get_cash_flow
Generates a detailed cash flow statement report for financial review.

### list_commerce_orders
Lists sales orders and transaction data pulled from connected e-commerce platforms like Shopify or BigCommerce.

### get_business
Gathers specific details, including metadata, for a named business entity within the system.

### list_journal_entries
Retrieves a list of recorded manual journal entries used for complex accounting adjustments.

### list_accounts
Provides the complete chart of accounts, listing every possible financial category.

### list_bills
Lists all outstanding bills (accounts payable) for a specific business to track what's owed out.

### list_businesses
Generates a comprehensive list of every registered business account managed by Railz.

### list_connections
Shows all active external service connections (like QuickBooks or Xero) for a given business profile.

### list_invoices
Retrieves and lists outstanding invoices (accounts receivable) for a specific business account.

### get_profit_and_loss
Generates the Profit & Loss statement, detailing revenue versus operating expenses over time.

## Prompt Examples

**Prompt:** 
```
List all businesses registered in my Railz account.
```

**Response:** 
```
I've retrieved your business directory. You currently have 3 registered entities: 'Acme Corp', 'Global Logistics', and 'Retail Ventures'. Which one would you like to inspect?
```

**Prompt:** 
```
Show active connections for business 'biz_123'.
```

**Response:** 
```
Business 'biz_123' has 2 active connections: 'QuickBooks Online' (conn_456) and 'Shopify' (conn_789). I can now pull reports or transaction data from either source.
```

**Prompt:** 
```
Get the Profit and Loss report for connection 'conn_456'.
```

**Response:** 
```
Fetching normalized P&L data... For the current period, your total revenue is $50,000 with operating expenses of $30,000, resulting in a net income of $20,000.
```

## Capabilities

### Reviewing business entities
You can list all businesses registered in your account and get detailed metadata for any specific one.

### Checking service connections
The MCP monitors which external services, like QuickBooks or Xero, are currently connected to a business's profile.

### Generating financial statements
You can fetch standard reports, including Balance Sheets, Profit & Loss statements, and Cash Flow data.

### Managing accounts payable/receivable
The agent queries and analyzes both outstanding invoices (accounts receivable) and pending bills (accounts payable).

### Tracking sales activity
You access transaction data and sales orders from connected commerce platforms to see revenue trends.

## Use Cases

### The Quarterly Client Review
A bookkeeper needs to prepare the quarterly review for three clients. Instead of logging into three different platforms, they ask their agent to list all registered businesses and then request a `get_balance_sheet` report for each one in sequence.

### Investigating Revenue Drops
A business owner notices revenue dipped last month. They prompt the agent to run `list_commerce_orders`, cross-reference it with the bank feeds via `list_bank_transactions`, and instantly spot where the sales dropped off.

### Pre-Audit Preparation
A financial analyst needs a quick overview before an audit. They ask for the `get_profit_and_loss` statement, then use `list_journal_entries` to verify any manual adjustments were made.

### Onboarding New Clients
A bookkeeper needs to assess a potential client. They run `list_businesses` and check the connection status using `list_connections`, confirming which systems are ready for integration before starting work.

## Benefits

- Stop switching between apps. Instead of manually checking QuickBooks, Xero, and your bank feed separately, you can ask the agent to list all transactions using `list_bank_transactions` and get one unified answer.
- Generate full financial reports on demand. Running a `get_balance_sheet` or `get_profit_and_loss` is now a simple command, eliminating hours of data export and spreadsheet manipulation.
- Maintain oversight across multiple clients. You can first run `list_businesses` to identify all entities, then drill down into each one to check its active connections using `list_connections`.
- Track cash flow automatically. Instead of digging through sales reports, you ask for the `get_cash_flow` statement and get a clear view of money coming in versus going out.
- Manage payables and receivables easily. You can instantly query both outstanding bills with `list_bills` and unpaid invoices using `list_invoices`, giving a complete picture of immediate cash needs.

## How It Works

The bottom line is you talk to your agent like talking to an accountant who already has access to every piece of your company's books.

1. First, subscribe to this MCP on Vinkius.
2. Next, input your Railz Client ID and Client Secret into your AI client.
3. Finally, ask your agent a financial question—the MCP handles the data retrieval from all connected platforms.

## Frequently Asked Questions

**How do I check if my client has active connections using Railz?**
Run `list_connections` for the specific business ID. This tool shows exactly which services like Xero or QuickBooks are connected and ready to provide data.

**Can I get a full profit and loss statement with Railz MCP?**
Yes, you use the `get_profit_and_loss` tool. It compiles revenue and expenses from multiple sources into one normalized report for analysis.

**Does Railz help me track invoices and bills?**
You can manage both accounts receivable (unpaid invoices) using `list_invoices`, and accounts payable (bills owed out) using `list_bills` to get a full picture of cash flow.

**What is the difference between listing bank transactions and getting cash flow with Railz?**
The `list_bank_transactions` tool gives you a raw list of every movement. The `get_cash_flow` tool takes that data, normalizes it, and presents it as a calculated statement.

**How do I see all the businesses managed by Railz?**
Use the `list_businesses` tool. This provides a master list of every single registered entity in your account that you can then inspect individually using `get_business`.