{"name":"cc.billsai/billsai","serverInfo":{"name":"billsai","title":"Bills AI","version":"1.0.0"},"description":"Bills AI lets an AI assistant convert a bank statement PDF to CSV and read the statements and transactions you saved in Bills AI. Every tool is read-only; sign-in is OAuth.","url":"https://billsai.cc/api/mcp","transport":{"type":"streamable-http","endpoint":"https://billsai.cc/api/mcp"},"authentication":{"required":true,"schemes":["oauth2","bearer"],"oauth":{"flow":"authorization_code","pkce":"S256","dynamicClientRegistration":true,"protectedResourceMetadata":"https://billsai.cc/.well-known/oauth-protected-resource/api/mcp","scope":"mcp:read"},"bearer":"Bills AI API key (bai_sk_..., paid plans) as Authorization: Bearer","note":"Sign in with OAuth 2.1 (dynamic client registration, PKCE S256): you log in to your Bills AI account and approve a consent screen. Any Bills AI account can connect, free ones included. A paid-plan API key (bai_sk_...) is also accepted as a Bearer token. The OAuth token is read-only, expires after 90 days and can be disconnected in Settings > Connected AI apps."},"capabilities":{"tools":{}},"tools":[{"name":"convert_statement_pdf","title":"Convert statement PDF to CSV","description":"Converts a text-layer bank statement PDF, supplied as a ChatGPT file attachment or as base64, into CSV holding the transaction table as printed on the statement. Returns the CSV text, column headers, row count, extraction method and warnings about skipped lines. The PDF is read in memory and is not stored. Scanned or photographed PDFs are not supported because no text recognition is applied, and password-protected PDFs are refused. Accepts attachments up to 10 MB and base64 up to 2 MB decoded.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true}},{"name":"create_statement_upload_url","title":"Create statement upload link","description":"Creates a one-time upload link, valid for 10 minutes, for a bank statement PDF of up to 10 MB. A PUT request with the PDF as the body to that link answers with the same CSV result as base64 conversion, so the file does not pass through the conversation. Suited to environments that can run an HTTP client. The PDF is read in memory and is not stored.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true}},{"name":"list_statements","title":"List saved statements","description":"Lists the bank statements saved in the signed-in Bills AI account: statement id, bank name, statement date, processing status, number of transactions and the financial health grade. File names are not included. Read-only.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true}},{"name":"list_transactions","title":"List saved transactions","description":"Returns saved transactions from the signed-in Bills AI account, newest first, with date, description, signed amount, debit or credit type, category and whether the spending is marked necessary. Filters narrow by statement, year, month, category or a text search, and results are paged. Read-only.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true}},{"name":"get_spending_summary","title":"Summarise spending","description":"Summarises saved transactions for a year, a month or all time: total income, total expenses, necessary and unnecessary spending, and the amount and number of transactions per category. Refunded transactions are excluded. Amounts are in the currencies of the statements, without conversion. Read-only.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true}},{"name":"export_transactions_csv","title":"Export saved transactions as CSV","description":"Exports saved transactions from the signed-in Bills AI account as CSV text, using the same filters as the transaction listing. Returns up to 1,000 rows per page together with the total row count. Text cells that begin with a formula character are prefixed with an apostrophe so spreadsheet apps treat them as text. Read-only.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true}}],"registry":{"name":"cc.billsai/billsai","url":"https://registry.modelcontextprotocol.io"},"repository":[{"name":"Claude Code plugin","url":"https://github.com/airdropfi/billsai-claude-plugin"},{"name":"Cursor kit","url":"https://github.com/airdropfi/billsai-cursor-kit"},{"name":"Gemini CLI extension","url":"https://github.com/airdropfi/billsai-gemini-extension"}],"organization":{"name":"Bills AI","url":"https://billsai.cc"},"documentationUrl":"https://billsai.cc/mcp","markdownDocumentation":"https://billsai.cc/mcp.md","llmsTxt":"https://billsai.cc/llms.txt","freeTool":{"name":"Free bank statement PDF to CSV converter (no signup)","url":"https://billsai.cc/tools/pdf-to-csv"},"pricing":{"url":"https://billsai.cc/pricing","markdown":"https://billsai.cc/pricing.md","plans":[{"name":"Free","usdPerMonth":0,"usdPerYear":0},{"name":"Starter","usdPerMonth":5,"usdPerYear":49},{"name":"Pro","usdPerMonth":12,"usdPerYear":99},{"name":"Business","usdPerMonth":29,"usdPerYear":249}]},"privacyPolicyUrl":"https://billsai.cc/privacy","termsOfServiceUrl":"https://billsai.cc/terms","contact":"support@billsai.cc"}