{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_2znvhm5fythh","handle":"ynab-mcp-2","url":"https://wellknown.network/agents/ynab-mcp-2","links":{"self":"https://wellknown.network/agents/ynab-mcp-2/record.json","html":"https://wellknown.network/agents/ynab-mcp-2","markdown":"https://wellknown.network/agents/ynab-mcp-2/record.md","api":"https://wellknown.network/api/v1/agents/ynab-mcp-2","status":"https://wellknown.network/api/v1/agents/ynab-mcp-2/status","claim":"https://wellknown.network/agents/ynab-mcp-2/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/ynab-mcp-2/claim.json","badge":"https://wellknown.network/agents/ynab-mcp-2/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:ynab-mcp-2","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"ynab-mcp","summary":"A Model Context Protocol server for interacting with YNAB","description":"# YNAB MCP Server\n\nA Model Context Protocol (MCP) server for interacting with YNAB (You Need A Budget) via their API. \n\n## Features\n\n- Get budgets, accounts, and categories\n- Get, create and update transactions\n- Create new categories\n- Update budgeted amounts for categories\n- Get budget summaries\n\n## Prerequisites\n\n- Python 3.13 or higher\n- A YNAB account with an API token ([Get your token here](https://app.ynab.com/settings/developer))\n- UV package manager (optional but recommended)\n\n## Installation\n\n1. Clone this repository\n   ```bash\n   git clone https://github.com/ntdef/ynab-mcp.git\n   cd ynab-mcp\n   ```\n\n2. Create a virtual environment\n   ```bash\n   uv venv\n   ```\n\n3. Activate the virtual environment\n   - Windows:\n     ```\n     venv\\Scripts\\activate\n     ```\n   - Unix/MacOS:\n     ```\n     source venv/bin/activate\n     ```\n\n4. Install dependencies using UV\n   ```bash\n   # python -m pip install uv\n   uv sync\n   ```\n\n5. Copy `.env.example` to `.env` and add your YNAB API token\n   ```bash\n   cp .env.example .env\n   # Edit .env with your favorite editor\n   ```\n\n## Usage\n\n### Running the server\n\n```bash\nuv run ynab-mcp\n```\n\nThe server will start in stdio mode, so you won't see any output.\n\n### Available tools\n\nThe YNAB MCP Server provides the following tools:\n\n#### Budget management\n- `get_budgets`: Retrieve all budgets for the authenticated user\n- `get_budget_summary`: Get a summary of the budget, optionally for a specific month\n\n#### Account management\n- `get_accounts`: Retrieve all accounts for a specific budget\n\n#### Category management\n- `get_categories`: Retrieve all categories for a specific budget\n- `create_category`: Create a new category in the specified budget group\n- `update_category_budgeted`: Update the budgeted amount for a category in a specific month\n\n#### Transaction management\n- `get_transactions`: Retrieve transactions for a specific budget, optionally filtered by date, account, or category\n- `create_transaction`: Create a new transaction in the…","publisher":null,"homepage":null,"repository":null,"version":"0.1.4","license":"MIT","protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:ynab-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"dev.version-control","name":"Version Control","confidence":1,"provenance":"derived"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.859,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"ynab-mcp","registry":"pypi","observedAt":"2026-09-10T16:24:26.849Z","publishedAt":"2026-02-24T04:35:36.035514Z","latestVersion":"0.1.4"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"ynab-mcp","url":"https://pypi.org/project/ynab-mcp/","firstSeenAt":"2026-09-10T16:23:21.303Z","fetchedAt":"2026-09-10T16:23:21.303Z","normalizedAt":"2026-09-10T16:23:21.303Z"}]},"firstSeenAt":"2026-09-10T16:23:21.303Z","updatedAt":"2026-09-10T16:24:26.849Z"}