Support · Legal
Verified RCS · SMS · MMS
API REFERENCE

MCP API

The SimplyRCS mcp API has 3 public endpoints. Every endpoint below is documented with its parameters, responses and an example request. The reference is public and needs no account; a scoped API key is required only to make live calls.

Model Context Protocol server configuration for AI-agent integrations.

Base URL https://api.simplyrcs.com · All 195 endpoints · Pricing

GET/v1/mcp/config

Get MCP server configuration

Returns the active MCP provider configuration for your platform. configured is false and data is null when no provider has been set up.

GET https://api.simplyrcs.com/v1/mcp/config · requires an API key

Responses

StatusReturnsDescription
200McpConfigStatusResponseSuccessful response
400ErrorResponseValidation error
401ErrorResponseAuthentication failed

Example request

curl -X GET https://api.simplyrcs.com/v1/mcp/config \
  -H 'Authorization: Bearer YOUR_API_KEY'

PUT/v1/mcp/config

Save MCP server configuration

Creates or updates the MCP provider configuration. baseUrl must be an https URL; credentials are encrypted at rest. Returns 422 when the organization has no platform mapping.

PUT https://api.simplyrcs.com/v1/mcp/config · requires an API key

Request body

McpConfigSaveRequest · optional

Responses

StatusReturnsDescription
200McpConfigResponseSuccessful response
400ErrorResponseValidation error
401ErrorResponseAuthentication failed

Example request

curl -X PUT https://api.simplyrcs.com/v1/mcp/config \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ "name": "Example request" }'

POST/v1/mcp/test

Test MCP server connectivity

Runs a health check against the configured MCP server for one channel (when channelType is supplied) or all of RCS, WHATSAPP, and SMS. Returns 400 NOT_CONFIGURED when no provider is configured. WA is accepted as an alias for WHATSAPP.

POST https://api.simplyrcs.com/v1/mcp/test · requires an API key

Request body

McpTestRequest · optional

Responses

StatusReturnsDescription
200McpTestResponseSuccessful response
400ErrorResponseValidation error
401ErrorResponseAuthentication failed

Example request

curl -X POST https://api.simplyrcs.com/v1/mcp/test \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ "name": "Example request" }'