Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.shingleai.com/llms.txt

Use this file to discover all available pages before exploring further.

The ShingleAI MCP server provides tools for managing your business communications and contacts. Tools are organized by resource type and require appropriate permissions to access.

Available Tool Categories

The MCP server exposes 106 tools across 11 resource categories. Each category has a dedicated reference page listing every tool, its parameters, permission, and return shape.
CategoryToolsDescription
Automations7Create, update, and inspect automations and their executions
Businesses20Business profile, offerings, and online/physical presences
Contacts20Contacts and their emails, phones, and addresses
Customers10Customer records and customer transactions
Domains15Domains, domain contacts, and domain registrations
Email Addresses2List and read connected email addresses
Email Templates7Manage templates, render previews, and send templated email
Files7Upload, download, search, and delete files; manage folders
Messages6Read messages, threads, and attachments; update status
Phone Numbers2List and read connected phone numbers
Tasks10Task CRUD, search, and assignee management

Permission Model

Each tool requires specific permissions to execute. Permissions follow the pattern resource:action (e.g., contacts:read) or resource.subresource:action for nested resources (e.g., contacts.emails:write). Permission levels:
ActionDescription
readView and list resources
writeCreate and update resources
deleteRemove resources
Examples:
  • contacts:read - List and view contacts
  • contacts:write - Create and update contacts
  • contacts.emails:write - Add or update contact email addresses
  • messages:read - View and search messages
You grant these permissions on the MCP server’s consent screen during the OAuth handshake. The set of tools advertised over tools/list is filtered against the categories you approve. See Authentication for the full flow.

Common Starting Points

Contact Tools

20 tools for managing contacts, emails, addresses, and phone numbers

Message Tools

6 tools for accessing messages, threads, and attachments

Task Tools

10 tools for managing tasks and assignees

File Tools

7 tools for uploading, downloading, and organizing files

Next Steps

Authentication

Learn how MCP clients authenticate to the server

Integrations

Connect to AI tools like Claude, Cursor, and Windsurf
Last modified on May 2, 2026