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"
      }
    }
  }
}

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_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_server_tenant",
    "arguments": {
      "serverApiKey": "rk_live_..."
    }
  }
}

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.

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

This first release exposes read-only tools only.

Last updated: June 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