Nynch MCP Server

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

47 tools across 5 categories: CRM read, CRM write, relationship intelligence, context query, and multi-agent orchestration.

Endpoint

Code

https://crcrwtjzqzinfzokianr.supabase.co/functions/v1/mcp-server

Transport: JSON-RPC 2.0 over Streamable HTTP. The server is stateless (no session to manage) and negotiates the protocol version with your client — it speaks 2025-11-25, 2025-06-18, and 2025-03-26.

Quick Start

1. Get an API Key

Scopes:

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

2. Configure Your Client

Claude Desktop

Add to claude_desktop_config.json:

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:

config.json

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

Python (MCP SDK)

server.ts

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)

3. Start Using Tools

Your AI client discovers available tools automatically. Ask it to search contacts, check your pipeline, create tasks, or analyze relationships.

Tool Catalog

CRM Read (11 tools)

Tool	Description
`search_contacts`	Search contacts by name, company, or tags
`get_contact_context`	Full contact context: profile, interactions, activities, notes, network
`search_deals`	Search deals by title, stage, or company
`get_deal_context`	Full deal context: stakeholders, learnings, coaching actions
`search_deals_by_inactivity`	Find stalled deals with no recent activity
`get_pipeline_summary`	Pipeline health: stage distribution, at-risk deals, upcoming closes
`get_next_best_actions`	AI-powered recommendations for what to do next
`get_who_list`	People to reach now, including identified site visitors. Never mention a specific page in outreach
`list_buckets`	List all buckets (lists/segments)
`get_bucket_contacts`	Get contacts in a specific bucket
`get_bucket_game_queue`	Get contacts waiting to be sorted into buckets

CRM Write (12 tools)

Tool	Description
`log_interaction`	Record a contact interaction (call, email, meeting, note)
`update_deal_stage`	Move a deal to a new pipeline stage
`create_task`	Create a task linked to a contact or deal
`create_note`	Add a note to a contact (supports markdown)
`create_contact`	Create a new contact (auto-links to company by domain)
`update_contact`	Update fields on an existing contact
`add_contact_to_bucket`	Add a contact to a bucket
`create_deal`	Create a new deal in the pipeline
`create_company`	Create a new company
`delete_contact`	Soft-delete a contact (recoverable)
`bulk_delete_contacts`	Soft-delete contacts by tag or ID list
`update_commitment`	Mark a commitment as completed or update details

Relationship Intelligence (11 tools)

Tool	Description
`get_authority_score`	Authority score across 6 dimensions
`get_commitments`	Commitments with Say/Do tracking and due dates
`get_buying_committee`	Stakeholder map: roles, influence, sentiment
`get_contact_signals`	Job changes, company changes, buying intent, identified website visits (no page paths)
`get_interaction_history`	Full interaction timeline with direction and sentiment
`get_relationship_score`	5-factor relationship strength score
`export_context_briefing`	AI-ready context briefing for any contact or deal
`get_relationship_trends`	Is engagement growing, stable, or declining?
`get_at_risk_relationships`	Contacts with dropping scores or no recent contact
`get_deal_intelligence`	Deal health: velocity, stakeholder coverage, risk factors
`get_weekly_briefing`	Weekly summary: interactions, changes, recommendations

Agent Orchestration (8 tools)

Tool	Description
`register_agent`	Register an external agent with capabilities and archetype
`list_agents`	List registered agents with status
`agent_heartbeat`	Confirm agent liveness
`write_context`	Write to the shared agent context store
`read_context`	Read from context store (supports prefix wildcards)
`create_handoff`	Request another agent to perform a task
`get_handoffs`	Get pending handoffs for your agent
`complete_handoff`	Mark a handoff as completed or failed

Context Query (5 tools)

Discover and read bounded slices of Nynch and connected-app context, metadata-first. Read-only — never accepts raw SQL.

Tool	Description
`list_context_sources`	List safe read-only context sources available to you
`search_context_sources`	Search context sources by natural-language keyword (metadata only)
`describe_context_source`	Describe one source: purpose, columns, filters, limits, availability
`list_context_columns`	List selectable columns and allowed filters for one source
`query_context`	Read a bounded slice from one source via a constrained query object

MCP Resources

URI Template	Description
`nynch://contacts/{id}`	Full contact context: profile, score, interactions, network
`nynch://deals/{id}`	Deal context: details, stakeholders, coaching actions
`nynch://pipeline/summary`	Pipeline health overview

Agent Orchestration

Nynch supports multi-agent workflows where AI agents register, share context, and hand off tasks:

Register with a name, capabilities, and archetype (producer, consumer, coordinator, critic)
Share state via a key-value context store with namespaces and TTLs
Route tasks by agent name or capability matching
Track liveness with heartbeats

Rate Limits

1,000 requests per hour per API key

Documentation

Full developer documentation: nynch.com/developers

About Nynch

Nynch is a relationship-led growth platform that helps consultants and professional services firms turn relationships into revenue. It combines CRM, relationship intelligence, and AI-powered coaching into a single platform.

License

This repository (documentation and configuration) is released under the MIT License. The Nynch MCP Server itself is a hosted service — no local installation required.