Nynch MCP Server

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

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

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

2. 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)

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.