nynch-mcp-server: Instructions file for Codex

Nynch MCP Server

A hosted Model Context Protocol (MCP) server that gives AI agents full access to Nynch — a relationship-led growth platform for consultants and professional services firms.

Repository: Configuration and documentation for the Nynch MCP Server endpoint. Version: 3.0.0 Transport: JSON-RPC 2.0 over Streamable HTTP Endpoint: https://crcrwtjzqzinfzokianr.supabase.co/functions/v1/mcp-server

---

Company Policy and Working Preferences

See nynch-OS AGENTS.md and standards/WORKING_WITH_PETER.md. Durable lessons go in this repo (or nynch-OS), never only in a tool's private memory.

---

Quick Start

Get an API Key

Sign up at nynch.com, then go to Settings → Integrations → Claude & AI Assistants and create an API key.

Scopes:

• read — Search, browse, and retrieve data
• read-write — Read + create, update, delete records
• admin — Full access including agent orchestration

Configure Your Client

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "nynch": {
      "url": "https://crcrwtjzqzinfzokianr.supabase.co/functions/v1/mcp-server",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "nynch": {
      "url": "https://crcrwtjzqzinfzokianr.supabase.co/functions/v1/mcp-server",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Python (MCP SDK)

from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client

async with streamablehttp_client(
    "https://crcrwtjzqzinfzokianr.supabase.co/functions/v1/mcp-server",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
) as (read, write, _):
    async with ClientSession(read, write) as session:
        await session.initialize()
        result = await session.call_tool("search_contacts", {"query": "Acme Corp"})
        print(result)