Model Context Protocol

Ringnity MCP

Connect AI clients to Ringnity through a secure MCP layer. The MCP server exposes tools, while Ringnity API remains the source of truth for tenant isolation, scopes, plan contracts, quota, billing, and audit.

Quick start View tools

streamable-http

MCP Client

Claude, Cursor, OpenAI Agents, or custom AI client.

Ringnity MCP

Stateless adapter that exposes safe tools over Streamable HTTP.

Ringnity API

Source of truth for auth, tenant isolation, scopes, billing, quota, and business rules.

Quick Start

Use the Ringnity MCP endpoint from any MCP-compatible client that supports Streamable HTTP.

{
  "mcpServers": {
    "ringnity": {
      "url": "https://mcp.ringnity.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_RINGNITY_TOKEN_OR_SERVER_API_KEY"
      }
    }
  }
}

Team group and call tools are pre-GA

MCP currently exposes authorized Team, group, active call-room, and capability snapshots only. It cannot create or join a room, invite or remove participants, transfer a host, end a call, select a media provider, or obtain a managed-media token. Write tools remain unavailable until multi-device acceptance and the controlled rollout complete.

Public Tools

Health, pricing, and tenant resolution can be called without exposing tenant data.

Private Tools

Tenant contacts and conversations require scoped Server API, Agent SDK, or platform tokens.

No Direct DB

MCP calls Ringnity API. Prisma/database and business rules remain inside the core API.

Available Tools

Tool	Auth	Purpose
ringnity_health	Public	Check Ringnity API reachability.
ringnity_public_pricing	Public	Read the pricing catalog used by ringnity.com.
ringnity_resolve_tenant	Public	Resolve a tenant slug into public workspace metadata.
ringnity_server_tenant	Server API key	Read tenant context for a scoped Server API key.
ringnity_server_sdk_readiness	Server API key	Check SDK readiness for a tenant.
ringnity_list_contacts	server:contact:read	List tenant contacts.
ringnity_get_contact	server:contact:read	Read one tenant contact.
ringnity_agent_list_conversations	agent:conversations:read	List conversations visible to an agent.
ringnity_agent_get_conversation	agent:conversations:read	Read one conversation.
ringnity_agent_get_conversation_messages	agent:messages:read	Read conversation messages.
ringnity_agent_list_team_conversations	agent:conversations:read	List direct and group Team conversations.
ringnity_agent_list_groups	agent:conversations:read	List groups where the Agent is an active member.
ringnity_agent_list_call_rooms	agent:calls:read	Recover active or joinable call-room snapshots without joining media.
ringnity_agent_call_capabilities	agent:calls:read	Read plan entitlement and controlled-rollout readiness.
ringnity_plan_contracts	Platform/admin token	Read canonical plan feature and quota contracts.

Call a Public Tool

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "ringnity_public_pricing",
    "arguments": {
      "currency": "USD",
      "locale": "en"
    }
  }
}

Call a Private Tool

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "ringnity_agent_list_call_rooms",
    "arguments": {}
  }
}

Send the scoped Ringnity credential only in the MCP Authorization header shown in Quick Start. Credentials are not accepted in tool arguments.

Security Notes

Prefer scoped Server API credentials over owner/admin dashboard tokens.

Do not pass passwords, OAuth secrets, or unrestricted API keys to MCP clients.

Send credentials only in the MCP Authorization header, never as tool arguments.

All tenant data access still flows through Ringnity API scope checks.

The pre-GA Team group/call surface is read-only and never returns media credentials.

Last updated: August 30, 2026

Turn Your Website Into a Real-Time Call Center

Let customers call your team directly from your website, no phone numbers and no apps required. Just add one <script>.

Talk to Sales Register Now