OSIR · The AI-Native Domain Registrar

Help Center / api

MCP protocol guide

MCP Protocol Guide

The Model Context Protocol (MCP) enables AI assistants like Claude to interact with our services directly.

What is MCP?

MCP is a standard protocol that allows AI models to:

  • Access external data and services
  • Perform actions on your behalf
  • Maintain context across conversations

Setting Up MCP

Step 1: Get MCP Credentials

  1. Go to Settings > Integrations
  2. Click Enable MCP
  3. Copy your MCP endpoint and token

Step 2: Configure Your AI Assistant

For Claude Desktop, add to your config:

{
  "mcpServers": {
    "osir": {
      "url": "https://be.osir.com/mcp",
      "token": "your_mcp_token"
    }
  }
}

Available MCP Tools

Domain Tools

Tool Description
search_domains Check domain availability
get_domain_info Get domain details
register_domain Register a new domain
list_domains List your domains

VPS Tools

Tool Description
list_servers List your VPS instances
create_server Deploy new server
server_action Start/stop/restart server
get_server_stats CPU, RAM, bandwidth usage

Example Conversations

User: "Is example.ai available?"

AI uses search_domains:

{
  "tool": "search_domains",
  "params": {
    "keyword": "example",
    "tlds": ["ai"]
  }
}

Response: "example.ai is available for $49.99/year. Would you like me to register it?"

User: "Show me my servers"

AI uses list_servers:

{
  "tool": "list_servers",
  "params": {}
}

Response: "You have 2 servers:

  1. web-prod (4GB RAM, NYC) - Running
  2. db-staging (2GB RAM, AMS) - Stopped"

Security

MCP connections are secured by:

  • Token authentication - Unique per user
  • Scope limitations - Only authorized actions
  • Audit logging - All actions recorded
  • Rate limiting - Prevents abuse

Permissions

Control what MCP can do:

Permission Description
read View resources only
write Create and modify
delete Remove resources
billing Access billing actions

Configure in Settings > MCP Permissions

Supported AI Platforms

  • Claude (Anthropic)
  • Custom integrations via MCP SDK

MCP vs REST API

Feature MCP REST API
Auth Token in config API key per request
Use case AI assistants Applications
Interaction Natural language JSON requests
Rate limits Per user Per key

Troubleshooting

AI can't connect:

  • Verify MCP is enabled
  • Check token is correct
  • Ensure endpoint URL is right

Actions failing:

  • Check permissions
  • Verify account has required services
  • Review rate limits