How to Use the Accommador MCP Server

This article will show you how to leverage the new Accommador MCP (Model Context Protocol) server to empower your AI agents and copilots to access Accommador data and tools seamlessly — all via a secure, standardized HTTP protocol. What is the MCP Server? The Accommador MCP server is a standardized, secure protocol that allows AI agents to read and write data in Accommador without needing SDKs or deep custom integrations.

You can now give agents access to critical tools like Calendar, Contacts, Conversations, Opportunities, and Payments through a single, unified interface.

Key Benefits of Using the MCP Server

Connecting your AI agents to Accommador has never been easier or safer.

• Standardized Access: Query and update data through a unified protocol.
• Fast Integration: No SDKs required; works with any HTTP-supporting client.
• Secure: Uses private integration tokens (PITs) for granular, permission-based access.
• Scalable: Designed for future expansion to 250+ tools.
• Flexible: Supports popular clients like Cursor, Windsurf, and OpenAI Playground.

Top 36 Tools AvailableBelow is the initial set of tools your AI agents can use today: #ToolEndpointDescription1Get Calendar Eventscalendars_get-calendar-eventsGet calendar events using userId, groupId, or calendarId. 2Get Appointment Notescalendars_get-appointment-notesRetrieve notes for a specific appointment. 3Get All Taskscontacts_get-all-tasksRetrieve all tasks for a contact.

4Add Tagscontacts_add-tagsAdd tags to a contact. 5Remove Tagscontacts_remove-tagsRemove tags from a contact. 6Get Contactcontacts_get-contactFetch contact details. 7Update Contactcontacts_update-contactUpdate a contact.

8Upsert Contactcontacts_upsert-contactUpdate or create a contact. 9Create Contactcontacts_create-contactCreate a new contact. 10Get Contactscontacts_get-contactsFetch all contacts. 11Search Conversationconversations_search-conversationSearch/filter/sort conversations.

12Get Messagesconversations_get-messagesRetrieve messages by conversation ID. 13Send a New Messageconversations_send-a-new-messageSend a message to a conversation thread. 14Get Locationlocations_get-locationGet location details by ID. 15Get Custom Fieldslocations_get-custom-fieldsRetrieve custom field definitions for a location.

16Search Opportunityopportunities_search-opportunitySearch for opportunities by criteria. 17Get Pipelinesopportunities_get-pipelinesFetch all opportunity pipelines. 18Get Opportunityopportunities_get-opportunityFetch opportunity details by ID. 19Update Opportunityopportunities_update-opportunityUpdate opportunity details.

20Get Order by IDpayments_get-order-by-idRetrieve payment order details. 21List Transactionspayments_list-transactionsFetch paginated list of transactions. 22Check Blog URL Slugblogs_check-url-slug-existsCheck the blog slug which is needed before publishing any blog post. 23Update Blog Postblogs_update-blog-postUpdate blog post for any given blog site24Create Blog Postblogs_create-blog-postcreate blog post for any given blog site25Get Blog Authorsblogs_get-all-blog-authors-by-locationget blog authors for a given location ID26Get Blog Categoriesblogs_get-all-categories-by-locationget blog categories for a given location ID27Get Blog Posts by Blog IDblogs_get-blog-postget blog posts for any given blog site using blog ID28Get Blogs by Locationblogs_get-blogsget blogs using Location ID29Create Email Templateemails_create-templateCreate a new template30Get Email Templatesemails_fetch-templateFetch email templates by location id31Get Social Media Accountssocialmediaposting_get-accountGet list of accounts and groups32Get Social Media Statisticssocialmediaposting_get-social-media-statisticsRetrieve analytics data for multiple social media accounts33Create Social Media Postsocialmediaposting_create-postCreate posts for all supported platforms34Get Social Media Postsocialmediaposting_get-postGet social media post35Get Social Media Postssocialmediaposting_get-postsGet social media posts36Update Social Media Postsocialmediaposting_edit-postEdit social media postHow To Set Up the MCP Server

1. Configure Your Agent/ClientAdd the MCP endpoint and headers to your agent configuration:jsonCopyEdit{  "mcpServers": {    "prod-accommador-mcp": {      "url": "https://services.Accommador.com/mcp/",      "headers": {        "Authorization": "Bearer <your-token>",        "locationId": "<account-id>"      }    }  }}
2. Get Your Private Integration Token (PIT)Go to Settings → Private Integrations in your Accommador location.Click Create New Integration.Select the required scopes (listed below).Copy and securely store your token.Required ScopesMake sure your PIT includes:View/Edit ContactsView/Edit ConversationsView/Edit Conversation MessagesView/Edit OpportunitiesView Calendars & Calendar EventsView LocationsView Payment Orders & TransactionsView Custom FieldsView FormsCheck Blog Post SlugUpdate Blog PostCreate Blog PostView Blog AuthorsView Blog CategoriesblogspostsreadonlyblogslistreadonlyCreate, Update and Delete Email TemplatesView Email TemplatesView Social Media AccountsView Social Media StatisticsEdit Social Media PostsView Social Media Posts
3. Start Building!Your agents can now call tools using natural language instructions, seamlessly translated into secure API calls via MCP.

Example

Tool CallPython example:pythonCopyEditimport requestsheaders = { "Authorization": "Bearer YOUR_PIT_TOKEN", "locationId": "YOUR_LOCATION_ID"}data = { "tool": "contacts_get-contact", "input": { "contactId": "abc123" }}response = requests.post( "https://services.Accommador.com/mcp/", headers=headers, json=data)print(response.json())Roadmap & VisionThe current MCP release is just the beginning.

Our roadmap includes: Individual MCP servers dedicated to specific services for targeted workflows.npx package to support clients without native HTTP support (e.g., Claude Desktop). OAuth support for advanced authorization flows. Expansion to 250+ tools to create a true unified orchestrator layer for AI agents. Enable complete automation of business processes across all Accommador modules.

Frequently Asked Questions

Q: Can I use this with OpenAI Playground or Claude? Yes! Any client supporting HTTP requests can integrate with MCP. Q: Do I need to install an SDK?

No SDK is required — MCP uses a standard HTTP protocol. Q: Is my data secure? Yes. Data access is fully scoped via Private Integration Tokens and secured through HTTPS.

Q: Can I restrict what tools an agent can use? Yes. You can control access by limiting scopes in your PIT. Q: What if I need a new tool or endpoint?

Reach out with feedback! We're actively expanding the available toolset.

Next Steps

Create your Private Integration Token and configure scopes. Update your AI agent or client configuration with the MCP endpoint. Start building agent-driven automations and integrations today! Provide feedback to help shape future expansions and new tool support.