Nynch

io.github.peterod99Published by GitHub account peterod99v3.1.0Updated Oct 26, 2026

Nynch, the AI CRM for consultants and fractionals: contacts, deals and relationship intelligence.

Overview

AI-generated overview

Hosted MCP server for Nynch, an AI CRM for consultants and fractionals, letting an assistant search contacts and deals, log activity and analyze relationship…

What you can do
  • Search and read CRM records: contacts, deals, pipeline summaries, buckets and next-best actions
  • Create and change CRM data: log interactions, move deal stages, create tasks, notes, contacts, companies and deals, and soft-delete contacts
  • Analyze relationships: authority and relationship scores, commitments, buying committees, signals, trends, at-risk relationships and briefings
  • Explore firm-wide intelligence: warm paths, reachable people through teammates, and won client outcomes
  • Query bounded read-only context sources from Nynch and connected apps
  • Coordinate multiple agents: register agents, share a context store, and create and complete handoffs
When to use it
Useful for consultants or fractional operators who keep their pipeline and relationship history in Nynch and want an assistant to summarize accounts, spot stalled deals, draft follow-ups or log activity without switching apps. Also relevant for teams running multi-agent workflows against shared CRM context.
Requirements
Remote Streamable HTTP endpoint at app.nynch.com; no local runtime. A Nynch account is required. Claude can connect via OAuth sign-in; other clients need an API key sent as an Authorization bearer header, created in Nynch settings. API key scopes are read, read-write or admin. Rate limit is 1,000 requests per hour per key.
Before you install
The API key is a secret sent in the Authorization header; choose the narrowest scope, since read-write allows creating, updating and deleting records and admin adds agent orchestration. Write tools change CRM data, and delete tools soft-delete contacts individually or in bulk. The server reads relationship context drawn from email, meetings and LinkedIn, and firm intelligence exposes colleagues' relationship data and client outcomes.

Installation

In SourceWeft

  1. Open Nynch in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.peterod99%2Fnynch/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "nynch": {
      "type": "http",
      "url": "https://app.nynch.com/mcp"
    }
  }
}

README

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:

json
{  "mcpServers": {    "nynch": {      "url": "https://app.nynch.com/mcp",      "headers": {        "Authorization": "Bearer YOUR_API_KEY"      }    }  }}
Cursor

Add to .cursor/mcp.json:

json
{  "mcpServers": {    "nynch": {      "url": "https://app.nynch.com/mcp",      "headers": {        "Authorization": "Bearer YOUR_API_KEY"      }    }  }}
Python (MCP SDK)
python
from mcp import ClientSessionfrom 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)

ToolDescription
search_contactsSearch contacts by name, company, or tags
get_contact_contextFull contact context: profile, interactions, activities, notes, network
search_dealsSearch deals by title, stage, or company
get_deal_contextFull deal context: stakeholders, learnings, coaching actions
search_deals_by_inactivityFind stalled deals with no recent activity
get_pipeline_summaryPipeline health: stage distribution, at-risk deals, upcoming closes
get_next_best_actionsAI-powered recommendations for what to do next
get_who_listPeople to reach now, including identified site visitors. Never mention a specific page in outreach
list_bucketsList all buckets (lists/segments)
get_bucket_contactsGet contacts in a specific bucket
get_bucket_game_queueGet contacts waiting to be sorted into buckets

CRM Write (12 tools)

ToolDescription
log_interactionRecord a contact interaction (call, email, meeting, note)
update_deal_stageMove a deal to a new pipeline stage
create_taskCreate a task linked to a contact or deal
create_noteAdd a note to a contact (supports markdown)
create_contactCreate a new contact (auto-links to company by domain)
update_contactUpdate fields on an existing contact
add_contact_to_bucketAdd a contact to a bucket
create_dealCreate a new deal in the pipeline
create_companyCreate a new company
delete_contactSoft-delete a contact (recoverable)
bulk_delete_contactsSoft-delete contacts by tag or ID list
update_commitmentMark a commitment as completed or update details

Relationship Intelligence (11 tools)

ToolDescription
get_authority_scoreAuthority score across 6 dimensions
get_commitmentsCommitments with Say/Do tracking and due dates
get_buying_committeeStakeholder map: roles, influence, sentiment
get_contact_signalsJob changes, company changes, buying intent, identified website visits (no page paths)
get_interaction_historyFull interaction timeline with direction and sentiment
get_relationship_score5-factor relationship strength score
export_context_briefingAI-ready context briefing for any contact or deal
get_relationship_trendsIs engagement growing, stable, or declining?
get_at_risk_relationshipsContacts with dropping scores or no recent contact
get_deal_intelligenceDeal health: velocity, stakeholder coverage, risk factors
get_weekly_briefingWeekly summary: interactions, changes, recommendations

Firm Intelligence (3 tools)

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

Agent Orchestration (8 tools)

ToolDescription
register_agentRegister an external agent with capabilities and archetype
list_agentsList registered agents with status
agent_heartbeatConfirm agent liveness
write_contextWrite to the shared agent context store
read_contextRead from context store (supports prefix wildcards)
create_handoffRequest another agent to perform a task
get_handoffsGet pending handoffs for your agent
complete_handoffMark 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.

ToolDescription
list_context_sourcesList safe read-only context sources available to you
search_context_sourcesSearch context sources by natural-language keyword (metadata only)
describe_context_sourceDescribe one source: purpose, columns, filters, limits, availability
list_context_columnsList selectable columns and allowed filters for one source
query_contextRead a bounded slice from one source via a constrained query object

MCP Resources

URI TemplateDescription
nynch://contacts/{id}Full contact context: profile, score, interactions, network
nynch://deals/{id}Deal context: details, stakeholders, coaching actions
nynch://pipeline/summaryPipeline 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

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.

Source: README.md at commit 9238f79

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

2
  1. v3.1.0LatestOct 26, 2026
  2. v1.0.0Sep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts