Skip to main content

​
Overview

Claude (by Anthropic) natively supports the Model Context Protocol. Connect Claude to any ezForge Ready MCP server to let it query business hours, browse offerings, check availability, and more — using its built-in MCP client.

​
Prerequisites

  • An ezForge Ready business with a deployed MCP server
  • Your MCP server URL (format: https://<slug>.mcp.ezforge.ai)
  • Claude Desktop ≥ 0.10 or access to the Claude API with MCP tool-use support

​
Connecting via Claude Desktop

Add the server to your Claude Desktop configuration file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS): 
{
  "mcpServers": {
    "my-business": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-http"],
      "env": {
        "MCP_SERVER_URL": "https://<slug>.mcp.ezforge.ai/sse"
      }
    }
  }
}
Replace <slug> with your business slug (visible in the Ready dashboard under Server → Settings). Claude Desktop will prompt you to authenticate via OAuth 2.1 on first connection.

​
Connecting via the Claude API

Use the MCP connector in the Claude API to pass tool results from an ezForge Ready server: 
import anthropic

client = anthropic.Anthropic()

response = client.beta.messages.create(
    model="claude-opus-4-6",
    max_tokens=1024,
    tools=[
        {
            "type": "mcp",
            "server_url": "https://<slug>.mcp.ezforge.ai",
            "server_name": "my-business",
        }
    ],
    messages=[{"role": "user", "content": "What are the business hours?"}],
    betas=["mcp-client-2025-04-04"],  # Update this string when the MCP client beta graduates or the date changes
)
print(response.content)
Maintenance: The betas=["mcp-client-2025-04-04"] header enables the MCP client beta in the Anthropic API. If the beta graduates to general availability or the beta string date changes, this value must be updated (or removed). Check the Anthropic changelog for the latest status.

​
OAuth 2.1 Authentication

ezForge Ready servers use OAuth 2.1 with PKCE (RFC 7636). Claude handles the full OAuth flow automatically — no manual token management required. Discovery endpoints:
EndpointPurpose
/.well-known/oauth-protected-resourceRFC 9728 — advertises the authorization server
/.well-known/oauth-authorization-serverRFC 8414 — authorization server metadata
/.well-known/mcp-server-metadataezForge discovery — business info, vertical, agent hints

​
Available Tools

All Ready MCP servers expose a common base tool set plus vertical-specific tools:

​
Base tools (all verticals)

ToolDescription
get_business_infoBusiness name, description, and category
get_hoursCurrent and weekly operating hours
get_contact_infoPhone, email, address, and website

​
Restaurant tools

ToolDescription
search_menuSearch menu items by keyword or category
get_menu_itemFull details for a single menu item
check_dietaryFilter items by dietary restriction
request_reservationRequest a table reservation
check_availabilityCheck reservation availability for a date/party size
place_orderPlace an online order

​
Salon & Spa tools

ToolDescription
search_servicesSearch services by keyword or category
get_service_detailsFull details for a single service
check_availabilityCheck appointment availability
book_appointmentBook an appointment
get_cancellation_policyRetrieve the cancellation policy

​
Home Services tools

ToolDescription
get_servicesList all offered services
check_service_areaCheck if a zip code is in the service area
request_quoteRequest a quote for a job
check_availabilityCheck appointment availability
verify_credentialsRetrieve licenses and insurance on file

​
Discovering Businesses

Use the ezForge directory API to find Ready-powered businesses: 
curl "https://ezforge.ai/api/v1/directory?vertical=restaurant&city=Detroit"
Each listing includes the mcpServerUrl you can pass directly to Claude.

​
Troubleshooting

Authentication loop — ensure your Claude Desktop is up to date; OAuth PKCE support requires ≥ 0.10. Tool not found — confirm the business has the relevant vertical template deployed. The get_business_info tool is available on every server; vertical tools depend on the template type. Rate limiting — the /.well-known/mcp-server-metadata endpoint is rate-limited per IP. If you are building a crawler or aggregator, cache the metadata response for at least 5 minutes.