# How to integrate Chaser MCP with Atomic Agent ```json { "title": "How to integrate Chaser MCP with Atomic Agent", "toolkit": "Chaser", "toolkit_slug": "chaser", "framework": "Atomic Agent", "framework_slug": "atomic-agent", "url": "https://composio.dev/toolkits/chaser/framework/atomic-agent", "markdown_url": "https://composio.dev/toolkits/chaser/framework/atomic-agent.md", "updated_at": "2026-08-11T13:07:39.806Z" } ``` ## Introduction Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,500+ apps through Composio, including Chaser. This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Chaser account. See the [Atomic Agent documentation](https://atomicagent.io/docs/?cta_placement=atomic-agent-docs) for installation instructions. ## Also integrate Chaser with - [OpenAI Agents SDK](https://composio.dev/toolkits/chaser/framework/open-ai-agents-sdk) - [Claude Agent SDK](https://composio.dev/toolkits/chaser/framework/claude-agents-sdk) - [Claude Code](https://composio.dev/toolkits/chaser/framework/claude-code) - [Claude Cowork](https://composio.dev/toolkits/chaser/framework/claude-cowork) - [Codex](https://composio.dev/toolkits/chaser/framework/codex) - [OpenClaw](https://composio.dev/toolkits/chaser/framework/openclaw) - [Hermes](https://composio.dev/toolkits/chaser/framework/hermes-agent) - [Google ADK](https://composio.dev/toolkits/chaser/framework/google-adk) - [LangChain](https://composio.dev/toolkits/chaser/framework/langchain) - [Vercel AI SDK](https://composio.dev/toolkits/chaser/framework/ai-sdk) - [Mastra AI](https://composio.dev/toolkits/chaser/framework/mastra-ai) - [LlamaIndex](https://composio.dev/toolkits/chaser/framework/llama-index) - [CrewAI](https://composio.dev/toolkits/chaser/framework/crew-ai) - [Pydantic AI](https://composio.dev/toolkits/chaser/framework/pydantic-ai) - [AutoGen](https://composio.dev/toolkits/chaser/framework/autogen) ## TL;DR ### How Atomic Agent connects to Chaser Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication. Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account. ## Connect Chaser to Atomic Agent ### Connect Chaser to Atomic Agent - Sign up or sign in to the [Composio dashboard](https://dashboard.composio.dev/?cta_placement=atomic-agent-api-key). Copy your API key. - In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart. - Ask Atomic Agent to do something in Chaser. It searches Composio for the right tool. - On first use, open the sign-in link returned in the chat. Connect your Chaser account, then return to Atomic Agent to continue. ### Headless setup Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file. ```bash COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY ``` ## What is the Chaser MCP server, and what's possible with it? The Chaser MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Chaser account. It provides structured and secure access to your accounts receivable data, so your agent can create and manage invoices, update customer records, generate credit notes, and retrieve key financial details on your behalf. - Automated invoice management: Create, update, and track invoices programmatically—making it easy for your agent to help you stay on top of accounts receivable. - Customer information handling: Retrieve, create, and update customer records so your assistant can help onboard new clients or keep customer details up-to-date. - Credit note processing: Generate and fetch credit notes, allowing your agent to handle adjustments and reconciliations quickly and accurately. - Organization data retrieval: Access up-to-date information about your organization, including IDs, currency settings, and compliance details, for seamless financial operations. - Efficient accounts review: Instantly pull lists of customers or credit notes to review outstanding balances, statuses, and financial health—all through conversational prompts. ## Supported Tools | Tool slug | Name | Description | |---|---|---| | `CHASER_CREATE_CONTACT_PERSON` | Create Contact Person | Tool to create a new contact person for a customer in Chaser. Requires customer_id and external_id. Use when adding additional contacts to an existing customer account. | | `CHASER_CREATE_INVOICE` | Create Invoice | Tool to create a new invoice record in the organization. Use after ensuring the customer exists in Chaser. | | `CHASER_CREATE_OVERPAYMENT` | Create Overpayment | Creates a new overpayment record in Chaser for tracking customer overpayments. Overpayments represent amounts paid by customers in excess of invoice amounts and can be used to offset future invoices. The customer must exist in Chaser before creating an overpayment (use POST /customers first if needed). Valid statuses: DRAFT, SUBMITTED, AUTHORISED, PAID, VOIDED, DELETED. | | `CHASER_DELETE_CONTACT_PERSON` | Delete Contact Person | Tool to delete a contact person from a customer record in Chaser. Use this when you need to remove a specific contact person associated with a customer. Requires both the customer identifier and the contact person identifier. | | `CHASER_GET_CONTACT_PERSON` | Get Contact Person by ID | Tool to get a specific contact person by ID for a customer. Use when you need to retrieve detailed information about a contact person associated with a customer in Chaser. | | `CHASER_GET_CREDIT_NOTE_BY_ID` | Get Credit Note by ID | Retrieve detailed information for a specific credit note by its ID. Accepts both internal Chaser IDs and external credit note IDs (with 'ext_' prefix). Use when you need to fetch complete details of a single credit note. | | `CHASER_GET_CREDIT_NOTES` | Get Credit Notes | Retrieves a list of credit notes from Chaser. Supports filtering by customer, status, and date range. Returns all credit notes if no filters are specified. | | `CHASER_GET_CURRENT_ORGANISATION` | Get Current Organisation | Tool to retrieve information about the current organisation associated with the API credentials. Use when you need the organisation ID, currency, timezone, or legal details for the authenticated account. | | `CHASER_GET_CUSTOMER_BY_ID` | Get Customer by ID | Retrieve detailed information for a specific customer by their Chaser customer ID. Use this after obtaining the customer_id from listing customers or creating a customer. The customer_id is the internal Chaser identifier (e.g., 'cust_abc123'), not the external_id from your source system. | | `CHASER_GET_CUSTOMERS` | Get Customers | Tool to retrieve a list of all customers associated with the organization. Use when you need to display or process complete customer contact and status information. | | `CHASER_GET_INVOICE` | Get Invoice by ID | Tool to retrieve detailed information for a specific invoice by its ID. Use when you need to view invoice details, payment status, or associated customer information. | | `CHASER_GET_ORGANIZATION` | Get Organization | Tool to retrieve information about the connected organizations. Use when you need organization IDs, currency, timezone, or legal details before other operations. | | `CHASER_GET_OVERPAYMENT` | Get Overpayment | Retrieve detailed information for a specific overpayment by its ID. Use when you need to fetch overpayment details, check remaining credit, or verify overpayment status. Both internal ID (e.g., op_XXX) and external ID with 'ext_' prefix are supported. | | `CHASER_GET_STATUS` | Get Status | Tool to check the status of the Chaser API. Use when you need to verify if the API is operational before making other requests. | | `CHASER_LIST_CONTACT_PERSONS` | List Contact Persons | Tool to retrieve contact persons for a specific customer. Returns a paginated list of contact persons with their details. Use when you need to get contact information for a customer's representatives. | | `CHASER_LIST_INVOICES` | List Invoices | Tool to retrieve invoices with pagination and filtering. Use when you need to fetch invoice records from Chaser with support for various filter criteria including status, amounts, dates, and customer information. | | `CHASER_LIST_OVERPAYMENTS` | List Overpayments | Tool to retrieve overpayments from Chaser with pagination and filtering. Use when you need to list overpayments, check remaining credits, or filter by customer, amount, currency, or date. | | `CHASER_POST_CREDIT_NOTE` | Create Credit Note | Creates a new credit note record in Chaser for tracking customer credits. Credit notes represent amounts owed to customers and are used to reduce outstanding invoices. The customer must exist in Chaser before creating a credit note (use POST /customers first). Note: ACTIVE is not a valid status for creating credit notes via API. Valid statuses: SUBMITTED, AUTHORISED, PAID, VOIDED, DELETED. | | `CHASER_POST_CUSTOMER` | Create Customer | Tool to create a new customer record in Chaser. Use after obtaining Basic Auth credentials. | | `CHASER_PUT_CREDIT_NOTE` | Update Credit Note | Update an existing credit note in Chaser. All fields are optional. Use this to modify credit note details such as amount, status, or customer association. | | `CHASER_PUT_CUSTOMER` | Update Customer | Tool to update an existing customer's information using their unique Chaser customer ID. Use after confirming the customer's ID (the 'id' field, not 'externalID'). Example: "Update contactEmailAddress for customer ID cust_abc123." | | `CHASER_PUT_INVOICE` | Update Invoice | Update an existing invoice in Chaser by its internal ID. Use this to modify invoice status, amounts, dates, payments, or customer associations. Requires the internal Chaser invoice ID (e.g., 'inv_abc123') from invoice creation or retrieval responses. | | `CHASER_UPDATE_CONTACT_PERSON` | Update Contact Person | Tool to update a contact person for a customer in Chaser. Use when you need to modify contact person details such as name, email, or phone numbers. | | `CHASER_UPDATE_OVERPAYMENT` | Update Overpayment | Tool to update an overpayment record in Chaser. Use when modifying overpayment details such as remaining credit, status, or other fields. All fields except overpayment_id are optional. | | `CHASER_UPLOAD_INVOICE_PDF` | Upload Invoice PDF | Upload a PDF file to an existing invoice in Chaser. Use this to attach invoice documentation. The file must be a valid PDF document and is sent as multipart/form-data. | | `CHASER_UPSERT_BULK_CUSTOMERS` | Bulk Upsert Customers | Tool to bulk upsert up to 100 customers in a single operation. Customers are matched by external_id (or id) for updates. Use when you need to create or update multiple customers efficiently. | | `CHASER_UPSERT_CONTACT_PERSONS` | Bulk Upsert Contact Persons | Tool to bulk insert or update contact persons for a customer. Use when you need to create or update multiple contact persons in a single request (up to 100). Matching is done by external_id - existing contacts with the same external_id will be updated, new ones will be inserted. | | `CHASER_UPSERT_CREDIT_NOTES_BULK` | Bulk Upsert Credit Notes | Tool to bulk upsert up to 100 credit notes in a single request. Matches by credit_note_id (or id). Use when you need to create or update multiple credit notes efficiently in Chaser. | | `CHASER_UPSERT_INVOICES` | Bulk Upsert Invoices | Tool to bulk upsert up to 100 invoices in a single request. Invoices are matched by invoice_id for updates or created if not found. Use when you need to create or update multiple invoices efficiently. | | `CHASER_UPSERT_OVERPAYMENTS_BULK` | Bulk Upsert Overpayments | Tool to bulk upsert up to 100 overpayments in Chaser, matching by overpayment_id. Use when you need to create or update multiple overpayment records in a single operation. | ## Supported Triggers None listed. ## Troubleshooting ### Why is my API key rejected? Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying. ### Why are Composio tools unavailable after saving a key? Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk. ### Does Composio have a free plan? The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See [Composio pricing](/pricing) for the current limits that apply to your connection. ## Complete Code None listed. ## Conclusion ### Use Chaser from Atomic Agent With your account connected, ask Atomic Agent to work with Chaser in natural language. You can connect more apps through the same Composio integration as you need them. Visit the [Atomic Agent website](https://atomicagent.io/?cta_placement=atomic-agent-site) or inspect the [Atomic Agent source code](https://github.com/AtomicBot-ai/atomic-agent?cta_placement=atomic-agent-repo). ## How to build Chaser MCP Agent with another framework - [OpenAI Agents SDK](https://composio.dev/toolkits/chaser/framework/open-ai-agents-sdk) - [Claude Agent SDK](https://composio.dev/toolkits/chaser/framework/claude-agents-sdk) - [Claude Code](https://composio.dev/toolkits/chaser/framework/claude-code) - [Claude Cowork](https://composio.dev/toolkits/chaser/framework/claude-cowork) - [Codex](https://composio.dev/toolkits/chaser/framework/codex) - [OpenClaw](https://composio.dev/toolkits/chaser/framework/openclaw) - [Hermes](https://composio.dev/toolkits/chaser/framework/hermes-agent) - [Google ADK](https://composio.dev/toolkits/chaser/framework/google-adk) - [LangChain](https://composio.dev/toolkits/chaser/framework/langchain) - [Vercel AI SDK](https://composio.dev/toolkits/chaser/framework/ai-sdk) - [Mastra AI](https://composio.dev/toolkits/chaser/framework/mastra-ai) - [LlamaIndex](https://composio.dev/toolkits/chaser/framework/llama-index) - [CrewAI](https://composio.dev/toolkits/chaser/framework/crew-ai) - [Pydantic AI](https://composio.dev/toolkits/chaser/framework/pydantic-ai) - [AutoGen](https://composio.dev/toolkits/chaser/framework/autogen) ## Related Toolkits - [Stripe](https://composio.dev/toolkits/stripe) - Stripe is a global online payments platform offering APIs for managing payments, customers, and subscriptions. Trusted by businesses for secure, efficient, and scalable payment processing worldwide. - [44API](https://composio.dev/toolkits/44api) - 44API is an API service for validating VAT and tax identifiers and returning company details. Use it to verify business tax data and manage account IP whitelists quickly. - [Airwallex](https://composio.dev/toolkits/airwallex) - Airwallex is a global financial platform providing business accounts, payments, payouts, FX, and cards. Built to simplify cross-border payments and streamline financial operations for businesses. - [Aiwyn Tax MCP](https://composio.dev/toolkits/aiwyn_tax_mcp) - Aiwyn Tax MCP is a tax estimation service powered by Aiwyn's federal and state tax engine. It helps teams estimate tax outcomes without building tax calculation logic from scratch. - [Alpaca](https://composio.dev/toolkits/alpaca) - Alpaca is a stock and crypto trading platform for commission-free trading, real-time market data, and algorithmic strategies. Use it to build brokerage apps, trading bots, and portfolio workflows with market connectivity. - [Alpha vantage](https://composio.dev/toolkits/alpha_vantage) - Alpha Vantage is a financial data platform offering real-time and historical stock market APIs. Get instant, reliable access to equities, forex, and technical analysis data for smarter trading decisions. - [Altoviz](https://composio.dev/toolkits/altoviz) - Altoviz is a cloud-based billing and invoicing platform for businesses. It streamlines online payments, expense tracking, and customizable invoice management. - [Benzinga](https://composio.dev/toolkits/benzinga) - Benzinga provides real-time financial news and data APIs for market coverage. It helps you track breaking news and actionable market insights instantly. - [Bigdata.com MCP](https://composio.dev/toolkits/bigdata_com_mcp) - Bigdata.com MCP provides grounded access to financial news, transcripts, filings, and entity intelligence. Ideal for building research workflows and generating timely market insights. - [Billsby](https://composio.dev/toolkits/billsby) - Billsby is a subscription billing platform for managing customers, subscriptions, invoices, products, plans, usage counters, add-ons, and allowances. It helps SaaS and subscription teams automate billing operations without building complex billing logic from scratch. - [Brex](https://composio.dev/toolkits/brex) - Brex provides corporate credit cards and spend management tailored for startups and tech businesses. It helps optimize company cash flow, streamline accounting, and accelerate business growth. - [Cashfree Payments MCP](https://composio.dev/toolkits/cashfree_payments_mcp) - Cashfree Payments MCP is a merchant payments platform that handles collection, payouts, subscriptions, settlements, refunds, and identity verification. Simplifies merchant money lifecycle management with unified, API-driven workflows. - [Clarity AI MCP](https://composio.dev/toolkits/clarity_ai_mcp) - Clarity AI MCP is an MCP toolkit for simulating SFDR 2.0 fund classifications from a fund name, ISIN, or CUSIP. Use it to tap Clarity AI disclosure data and modeling without building custom sustainability-data workflows. - [Clientary](https://composio.dev/toolkits/clientary) - Clientary is a platform for managing clients, invoices, projects, proposals, and more. It streamlines client work and saves you serious admin time. - [Coinbase](https://composio.dev/toolkits/coinbase) - Coinbase is a platform for buying, selling, and storing cryptocurrency. It makes exchanging and managing crypto simple and secure for everyone. - [Coinbase Wallet MCP](https://composio.dev/toolkits/coinbase_wallet_mcp) - Coinbase Wallet MCP is Coinbase's wallet service for interacting with onchain accounts. Use it to give agents secure, structured access to inspect wallets and request onchain actions. - [Coinranking](https://composio.dev/toolkits/coinranking) - Coinranking is a comprehensive cryptocurrency market data platform offering access to real-time coin prices, market caps, and historical data. Get accurate, up-to-date stats for thousands of digital assets in one place. - [Coupa](https://composio.dev/toolkits/coupa) - Coupa is a business spend management platform for procurement, invoicing, and expenses. It helps organizations streamline purchasing, control costs, and gain complete visibility over financial operations. - [CurrencyScoop](https://composio.dev/toolkits/currencyscoop) - CurrencyScoop is a developer-friendly API for real-time and historical currency exchange rates. Easily access fiat and crypto data for smart, up-to-date financial applications. - [Daffy](https://composio.dev/toolkits/daffy) - Daffy is a modern charitable giving platform with a donor-advised fund. Easily set aside funds, grow them tax-free, and donate to over 1.7 million U.S. charities. ## Frequently Asked Questions ### What are the differences in Tool Router MCP and Chaser MCP? With a standalone Chaser MCP server, the agents and LLMs can only access a fixed set of Chaser tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Chaser and many other apps based on the task at hand, all through a single MCP endpoint. ### Can I use Tool Router MCP with Atomic Agent? Yes, you can. Atomic Agent fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Chaser tools. ### Can I manage the permissions and scopes for Chaser while using Tool Router? Yes, absolutely. You can configure which Chaser scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do. ### How safe is my data with Composio Tool Router? All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Chaser data and credentials are handled as safely as possible. --- [See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)