# How to integrate Beaconstac MCP with Atomic Agent

```json
{
  "title": "How to integrate Beaconstac MCP with Atomic Agent",
  "toolkit": "Beaconstac",
  "toolkit_slug": "beaconstac",
  "framework": "Atomic Agent",
  "framework_slug": "atomic-agent",
  "url": "https://composio.dev/toolkits/beaconstac/framework/atomic-agent",
  "markdown_url": "https://composio.dev/toolkits/beaconstac/framework/atomic-agent.md",
  "updated_at": "2026-08-11T13:06:40.242Z"
}
```

## 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 Beaconstac.
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 Beaconstac account. See the [Atomic Agent documentation](https://atomicagent.io/docs/?cta_placement=atomic-agent-docs) for installation instructions.

## Also integrate Beaconstac with

- [OpenAI Agents SDK](https://composio.dev/toolkits/beaconstac/framework/open-ai-agents-sdk)
- [Claude Agent SDK](https://composio.dev/toolkits/beaconstac/framework/claude-agents-sdk)
- [Claude Code](https://composio.dev/toolkits/beaconstac/framework/claude-code)
- [Claude Cowork](https://composio.dev/toolkits/beaconstac/framework/claude-cowork)
- [Codex](https://composio.dev/toolkits/beaconstac/framework/codex)
- [OpenClaw](https://composio.dev/toolkits/beaconstac/framework/openclaw)
- [Hermes](https://composio.dev/toolkits/beaconstac/framework/hermes-agent)
- [Google ADK](https://composio.dev/toolkits/beaconstac/framework/google-adk)
- [LangChain](https://composio.dev/toolkits/beaconstac/framework/langchain)
- [Vercel AI SDK](https://composio.dev/toolkits/beaconstac/framework/ai-sdk)
- [Mastra AI](https://composio.dev/toolkits/beaconstac/framework/mastra-ai)
- [LlamaIndex](https://composio.dev/toolkits/beaconstac/framework/llama-index)
- [CrewAI](https://composio.dev/toolkits/beaconstac/framework/crew-ai)
- [Pydantic AI](https://composio.dev/toolkits/beaconstac/framework/pydantic-ai)
- [AutoGen](https://composio.dev/toolkits/beaconstac/framework/autogen)

## TL;DR

### How Atomic Agent connects to Beaconstac
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 Beaconstac to Atomic Agent

### Connect Beaconstac 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 Beaconstac. It searches Composio for the right tool.
- On first use, open the sign-in link returned in the chat. Connect your Beaconstac 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 Beaconstac MCP server, and what's possible with it?

The Beaconstac MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Beaconstac account. It provides structured and secure access to your QR code and proximity marketing assets, so your agent can perform actions like creating QR templates, managing places and tags, and organizing collections on your behalf.
- QR code template creation and management: Easily instruct your agent to create new QR code templates or delete outdated ones, streamlining your marketing campaigns.
- Place and location asset organization: Let your agent register new places or list all your locations for precise proximity marketing management.
- Bulk QR code collection browsing: Have your agent search, filter, and organize your bulk QR code collections to keep assets accessible and sorted.
- Tagging and categorization automation: Direct your agent to create or delete tags, making it simple to categorize and organize QR codes and related objects.
- Organization and user management: Enable your agent to list organizations, onboard new users, or manage access for streamlined account administration.

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `BEACONSTAC_CREATE_PLACE` | Create Place | Tool to create a new place for location-based assets. Use when you need to register a new physical place under an organization. |
| `BEACONSTAC_CREATE_QR_TEMPLATE` | Create QR Template | Creates a new QR Code template with customizable design attributes. QR Code templates allow you to define reusable design presets for QR codes in your organization. You can customize colors, patterns, shapes, gradients, logos, frames, and more. Once created, templates can be applied to multiple QR codes for consistent branding. Use this when you need to: - Create branded QR code designs for your organization - Set up reusable design presets for QR code campaigns - Define custom styling including colors, patterns, logos, and frames |
| `BEACONSTAC_CREATE_TAG` | Create Tag | Tool to create a new tag for organizing QR Codes and other objects. Use when you need to categorize QR Codes under a specific organization. |
| `BEACONSTAC_CREATE_USER` | Create User | Tool to create a new User. Use when onboarding a new user under your organization (Reseller plan and above). |
| `BEACONSTAC_DELETE_QR_CODE` | Delete QR Code | Tool to delete a QR Code by its ID. Use when you need to remove an existing QR Code after validation. |
| `BEACONSTAC_DELETE_QR_TEMPLATE` | Delete QR Code Template | Tool to delete a QR Code template by its ID. Use when you need to permanently remove a QR Code template that is no longer needed. |
| `BEACONSTAC_DELETE_TAG` | Delete Tag | Tool to delete a tag by its ID. Use when you need to remove an existing Tag after validation. |
| `BEACONSTAC_LIST_BULK_QR_CODES` | List Bulk QR Code Collections | Tool to list Bulk QR Code collections. Use when you need to filter, search, or order your bulk QR Code collections. |
| `BEACONSTAC_LIST_ORGANIZATIONS` | List Organizations | List all organizations accessible to the authenticated account. Use this tool when you need to: - Get a list of all organizations the user has access to - Retrieve organization details including IDs, names, and configuration - Access organization feature permissions and account limits - Check subscription status and owner information The response includes comprehensive organization data with pagination support. |
| `BEACONSTAC_LIST_PLACES` | List Places | Tool to list your Places. Use when you need to browse or search your account's Places with filtering and ordering. |
| `BEACONSTAC_LIST_QR_TEMPLATES` | List QR Templates | Tool to list all QR code templates in your account. Use when you need to filter and paginate templates. |
| `BEACONSTAC_LIST_TAGS` | List Tags | Tool to list all tags with optional filtering and pagination. Use when you need to browse or search tags in your account. |
| `BEACONSTAC_LIST_USERS` | List Users | Tool to list all users with optional filtering, searching, ordering, and pagination. Use when you need to retrieve user records across your organization. |
| `BEACONSTAC_PERIOD_OVERVIEW` | Get Period Overview | Tool to get period overview analytics for products including counts, impressions, and conversion percentage. Use after specifying the product_type and time interval. |
| `BEACONSTAC_PRODUCT_OVERVIEW` | Get Product Overview | Tool to get analytics overview for a specified product type over a given time interval. Use after specifying the product type and time range to obtain summary metrics. |
| `BEACONSTAC_RETRIEVE_QR_CODE` | Retrieve QR Code | Retrieve detailed information about a specific QR Code by its ID. Returns QR code properties including name, type (static/dynamic), short URL, encoded data, design attributes, scan count, organization, and timestamps. Use this when you need to fetch, verify, or inspect QR Code details after creation or update. |
| `BEACONSTAC_RETRIEVE_USER` | Retrieve User | Tool to retrieve the details of an existing User by ID. Use when you need to fetch a user's profile after confirming its existence. |
| `BEACONSTAC_UPDATE_PLACE` | Update Place | Tool to update the specified Place by ID. Use after retrieving the Place to modify its details, such as name, address, or coordinates. |
| `BEACONSTAC_UPDATE_QR_CODE` | Update QR Code | Update an existing QR Code by its ID. Modify QR Code properties like name, design attributes, tags, and content. Returns the complete updated QR Code object. Important: When updating qr_type, you must also provide the corresponding content: - For static QR codes (qr_type=1): Include fields_data with qr_type and content (e.g., url) - For dynamic QR codes (qr_type=2): Include campaign with content_type and custom_url |
| `BEACONSTAC_UPDATE_TAG` | Update Tag | Tool to update an existing tag by its ID. Use when you need to modify a tag's name or color after confirming its ID via list_tags. |
| `BEACONSTAC_UPDATE_USER` | Update User | Tool to update an existing User. Use when you need to modify profile details or organization of a User by their ID. |

## 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 Beaconstac from Atomic Agent
With your account connected, ask Atomic Agent to work with Beaconstac 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 Beaconstac MCP Agent with another framework

- [OpenAI Agents SDK](https://composio.dev/toolkits/beaconstac/framework/open-ai-agents-sdk)
- [Claude Agent SDK](https://composio.dev/toolkits/beaconstac/framework/claude-agents-sdk)
- [Claude Code](https://composio.dev/toolkits/beaconstac/framework/claude-code)
- [Claude Cowork](https://composio.dev/toolkits/beaconstac/framework/claude-cowork)
- [Codex](https://composio.dev/toolkits/beaconstac/framework/codex)
- [OpenClaw](https://composio.dev/toolkits/beaconstac/framework/openclaw)
- [Hermes](https://composio.dev/toolkits/beaconstac/framework/hermes-agent)
- [Google ADK](https://composio.dev/toolkits/beaconstac/framework/google-adk)
- [LangChain](https://composio.dev/toolkits/beaconstac/framework/langchain)
- [Vercel AI SDK](https://composio.dev/toolkits/beaconstac/framework/ai-sdk)
- [Mastra AI](https://composio.dev/toolkits/beaconstac/framework/mastra-ai)
- [LlamaIndex](https://composio.dev/toolkits/beaconstac/framework/llama-index)
- [CrewAI](https://composio.dev/toolkits/beaconstac/framework/crew-ai)
- [Pydantic AI](https://composio.dev/toolkits/beaconstac/framework/pydantic-ai)
- [AutoGen](https://composio.dev/toolkits/beaconstac/framework/autogen)

## Related Toolkits

- [Metaads](https://composio.dev/toolkits/metaads) - Metaads is Meta's official Ads API that lets you manage, analyze, and optimize your Facebook and Instagram ad campaigns. Streamline ad operations and gain deeper insights with robust automation.
- [Adrapid](https://composio.dev/toolkits/adrapid) - Adrapid is a platform for rapid creation of digital marketing visuals using templates. It streamlines design workflows for banners, images, and HTML5 content with automation.
- [Adtraction](https://composio.dev/toolkits/adtraction) - Adtraction is an affiliate marketing platform for partner programs, tracking links, transactions, commissions, statistics, and payments. It helps advertisers and publishers manage performance marketing with clear reporting and payout workflows.
- [Adyntel](https://composio.dev/toolkits/adyntel) - Adyntel is an API that retrieves LinkedIn ads for any company using a domain or LinkedIn Page ID. Easily access competitive ad intelligence to power your marketing workflows.
- [Bouncify](https://composio.dev/toolkits/bouncify) - Bouncify is an email verification service for single addresses and bulk lists. Use it to reduce bounces, protect sender reputation, and track verification credits.
- [Bulk Email Checker](https://composio.dev/toolkits/bulk_email_checker) - Bulk Email Checker is an email verification service for checking address validity, mailbox status, domains, and mail-server signals. It helps reduce bounces, spot risky emails, and keep outreach lists cleaner before you send.
- [Campaign cleaner](https://composio.dev/toolkits/campaign_cleaner) - Campaign cleaner is an email campaign optimization tool that boosts compatibility and deliverability across email clients. It helps marketers get better results by cleaning, enhancing, and ensuring high performance for every campaign.
- [Deadline funnel](https://composio.dev/toolkits/deadline_funnel) - Deadline Funnel lets you create personalized deadlines and timers for your marketing campaigns. It helps marketers boost conversions by adding authentic urgency to offers.
- [DeBounce](https://composio.dev/toolkits/debounce) - DeBounce is an email verification service for checking address validity, deliverability, and risk. It helps keep contact lists clean so your campaigns reach real inboxes.
- [Easy Email Verification](https://composio.dev/toolkits/easy_email_verification) - Easy Email Verification is an email validation service for checking single addresses and bulk lists. Use it to reduce bounces, clean contact data, and protect sender reputation.
- [Elastic Email](https://composio.dev/toolkits/elastic_email) - Elastic Email is an email delivery and marketing platform for transactional emails, campaigns, contacts, and reporting. Use it to send reliable emails, manage audiences, verify addresses, and track performance.
- [Fairing](https://composio.dev/toolkits/fairing) - Fairing is a post-purchase survey and attribution platform for ecommerce brands. It helps teams measure which marketing channels, campaigns, and customer touchpoints drive purchases.
- [GoDaddy MCP](https://composio.dev/toolkits/godaddy_mcp) - GoDaddy MCP is a domain discovery toolkit for checking availability and generating AI-powered name ideas. Use it to move from rough business keywords to practical domain options fast.
- [Google Ads](https://composio.dev/toolkits/googleads) - Google Ads is Google's online advertising platform for creating, managing, and optimizing digital campaigns. It helps businesses reach targeted customers and maximize return on ad spend.
- [Handwrite.io](https://composio.dev/toolkits/handwrite) - Handwrite.io is a direct mail service for creating physical handwritten card orders. It helps teams send personal cards with selectable handwriting, stationery, and tracking.
- [Inblog](https://composio.dev/toolkits/inblog) - Inblog is an AI-powered blogging platform for posts, authors, tags, redirects, design settings, analytics, and lead forms. Use it to manage SEO-focused content, measure performance, and capture blog leads in one place.
- [Instantly](https://composio.dev/toolkits/instantly) - Instantly is a platform for automating cold email outreach, managing leads, and optimizing deliverability. Get better results from email campaigns with minimal manual effort.
- [Invalid Bounce](https://composio.dev/toolkits/invalid_bounce) - Invalid Bounce is an email verification service with a bulk verification API. Use it to clean email lists, reduce bounces, and protect sender reputation.
- [Keyword](https://composio.dev/toolkits/keyword) - Keyword.com is a digital marketing platform for search rank tracking and SEO analytics. Use it to monitor keyword performance, spot ranking changes, and measure SEO visibility.
- [lc.cx](https://composio.dev/toolkits/lc_cx) - lc.cx is a URL shortening service for branded links, workspaces, tags, QR codes, and click stats. Use it to share cleaner links, track performance, and manage branded campaigns from one API.

## Frequently Asked Questions

### What are the differences in Tool Router MCP and Beaconstac MCP?

With a standalone Beaconstac MCP server, the agents and LLMs can only access a fixed set of Beaconstac tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Beaconstac 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 Beaconstac tools.

### Can I manage the permissions and scopes for Beaconstac while using Tool Router?

Yes, absolutely. You can configure which Beaconstac 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 Beaconstac data and credentials are handled as safely as possible.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)