Nynch Mcp Server

Nynch MCP Server

Website: www.nynch.com · Developer docs: www.nynch.com/developers · Endpoint: https://app.nynch.com/mcp

The official, hosted Model Context Protocol server for Nynch, the AI CRM for consultants and fractionals who win high-value deals based on relationships.

50 tools across 6 categories: CRM read, CRM write, relationship intelligence, firm intelligence, context query, and multi-agent orchestration.

Endpoint

https://app.nynch.com/mcp

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.

The older endpoint https://crcrwtjzqzinfzokianr.supabase.co/functions/v1/mcp-server still answers, but it is deprecated. Use https://app.nynch.com/mcp in new configs.

Quick Start

Claude (custom connector, OAuth, no API key)

In Claude, open Settings → Connectors → Add custom connector and enter https://app.nynch.com/mcp. Click Connect, sign in with your Nynch account and approve access. Revoke access any time in Nynch under Settings → Integrations → AI hosts.

Other MCP clients (API key)

1. Get an API Key

Sign up at www.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://app.nynch.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "nynch": {
      "url": "https://app.nynch.com/mcp",
      "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://app.nynch.com/mcp",
    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

Firm Intelligence (3 tools)

Tool	Description
get_firm_warm_paths	Who at your firm knows this person or company, ranked by relationship strength. Metadata only, never email content
find_firm_reachable_people	People you can reach through a teammate, strongest path first, with the best teammate to ask for an intro
get_firm_client_outcomes	Client work the firm has won: value, retainer, owner, primary contact, referrer, totals by currency

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

• Developer docs: www.nynch.com/developers
• MCP discovery: www.nynch.com/.well-known/mcp
• OpenAPI: www.nynch.com/openapi.json

About Nynch

Nynch is the AI CRM for consultants and fractionals who win high-value deals based on relationships. It remembers relationship context across email, meetings and LinkedIn, and surfaces it when a conversation is worth having.

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.