MCP

Growhold works the same from its workspace and from the AI you already use. Through the Model Context Protocol, any MCP-capable assistant gets Growhold's live market intelligence, agents, builds and reviews as tools while you research, plan or write code.

Growhold in any AI

MCP is the open standard AI assistants use to call tools. Growhold publishes one MCP server, and every client that speaks the protocol can use it: Claude on the web and desktop, Claude Code, Cursor, Windsurf, VS Code assistants and your own agents. You connect once and then ask in plain words; nothing here is a developer feature.

What the connector gives your AI

Everything the workspace can do, as tools the assistant calls mid-conversation: search live buyer demand and what is already being built, read market gaps and buyer clusters, list your builds and their deliverables, start an agent in a build and read its cards, check whether a build's deliverables still agree, and add to the knowledge base. The results are the same cards, runs and reviews you see in the workspace, and they appear there too.

What to ask for

  • “What are accelerator programme managers paying for right now, and where is supply thin?”
  • “Give me the brief and the deliverables of the Verdict Evals build before I plan the sprint.”
  • “Run the Gap Validator in that build on this idea, then read the verdict back to me.”
  • “Do the deliverables in this build still agree? Show me what needs review.”
  • In a coding assistant: “Pull the solution design and its business rules from Growhold and implement the first slice.”

What stays your decision

Reading is free-form. Changing a build is not: starting a run spends credits like it does in the workspace, and accepting or dismissing a deliverable review is only done when you say so. The server tells the assistant this, and the tools follow the permissions of the key or connector you created.

Connect

Two ways in. Both start on the API & Devs page of your workspace. The server address is https://api.growhold.com/mcp.

Sign in from the assistant (OAuth)

For assistants that add connectors by signing in, such as Claude on the web and desktop: create an OAuth client on the API & Devs page, then add Growhold as a custom connector in the assistant with the server address, the client id and the secret. The assistant signs in with your workspace and the tools appear in every conversation. Revoking the client disconnects it at once.

Use an API key

For assistants and agents configured by file or command, such as Claude Code, Cursor and Claude Desktop: create an API key on the API & Devs page and give the client the server address with the key as a bearer token. Keys are scoped by area, so a key with only the knowledge permission gives an assistant market intelligence and nothing else.

Client configuration

Every client takes the same two things: the address and the Authorization header. The shape most clients use:

{
  "mcpServers": {
    "growhold": {
      "url": "https://api.growhold.com/mcp",
      "headers": { "Authorization": "Bearer gh_your_api_key" }
    }
  }
}
ClientWhere it goes
Claude (web, desktop, mobile)Settings, Connectors, Add custom connector: use OAuth as above
Claude Desktop (key)claude_desktop_config.json, the block above
Claude Codeclaude mcp add --transport http growhold https://api.growhold.com/mcp --header "Authorization: Bearer gh_your_api_key"
Cursor.cursor/mcp.json in the project, the block above
Other MCP clientsStreamable HTTP transport with the address and header above

Tools

The server exposes the same actions as the REST API, as tools. Names follow the API action with an underscore: runs.start is runs_start.

Available tools

ToolPermissionDescription
knowledge_base_listknowledgeList knowledge entries
knowledge_base_addknowledgeAdd text or file as knowledge
knowledge_base_removeknowledgeRemove a knowledge entry
knowledge_base_applyknowledgeApply knowledge to agent/specialist
builds_listrunsList builds: the products or ideas work is organised under
builds_getrunsOne build with its recent runs and outcomes
builds_createrunsCreate a build for a new product or idea
runs_listrunsList agent runs with their build
runs_getrunsGet run details with build and cards
runs_startrunsStart an async agent run in a build (build_id required, or none)
runs_stoprunsStop a running agent
runs_deleterunsDelete a run and its cards (needs confirm)
runs_pauserunsPause a running agent
runs_resumerunsResume a paused agent
runs_cards_listrunsList output cards for a run
runs_cards_getrunsGet card with signed file URLs
reviews_listrunsDeliverable reviews in a build: what no longer agrees after a later run
reviews_checkrunsCompare a run with the build's other deliverables
reviews_acceptrunsApply a proposed tune to the deliverable (user decision)
reviews_dismissrunsLeave the deliverable as it is (user decision)
knowledge_cards_listknowledgeList knowledge cards
knowledge_cards_getknowledgeGet a knowledge card
insights_overviewknowledgeMarket overview: top demand categories, gaps and buyer clusters
insights_clustersknowledgeDemand clusters for a mode (build, automate, deliver) and vertical
search_demandknowledgeSemantic search over demand statements (what buyers need)
explore_demand_clustersknowledgeBrowse demand clusters by size, growth or nearest to a query
demand_cluster_detailknowledgeStatements inside one demand cluster
query_demandknowledgeCount buyer requests by industry, buyer type, intent and more
find_demand_tagsknowledgeMost frequent tools, skills and concepts across buyer requests
search_supplyknowledgeSemantic search over solution statements (what is being built)
explore_supply_clustersknowledgeBrowse solution clusters by size or nearest to a query
supply_cluster_detailknowledgeStatements inside one solution cluster
query_supplyknowledgeCount products by industry, product type, workflow or seller type
find_supply_tagsknowledgeMost frequent integrations, concepts and topics across products
search_buyersknowledgeSemantic search over buyer persona statements (who the buyers are)
explore_buyer_clustersknowledgeBrowse buyer clusters (personas) by size or nearest to a query
buyer_cluster_detailknowledgePersona statements in one buyer cluster, plus what they ask for
schedules_listschedulesList schedules
schedules_createschedulesCreate a schedule
schedules_updateschedulesUpdate a schedule
schedules_deleteschedulesDelete a schedule
schedules_pauseschedulesPause a schedule
schedules_resumeschedulesResume a schedule
agents_listagentsList agents
agents_getagentsGet agent details
specialists_listspecialistsList specialists
specialists_getspecialistsGet specialist details

Permissions and credits

A tool is offered only when the key or connector carries its permission: knowledge, runs, schedules, agents or specialists. Market intelligence queries, chat and agent runs spend the workspace's credits at the same prices as in the app; listing and reading cost nothing.

Advanced

For your own agents or a client without MCP support, the server speaks plain JSON-RPC 2.0 over HTTP.

Raw JSON-RPC

List tools

curl -X POST https://api.growhold.com/mcp \
  -H "Authorization: Bearer gh_your_key" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}'

Call a tool

curl -X POST https://api.growhold.com/mcp \
  -H "Authorization: Bearer gh_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "search_demand",
      "arguments": { "query": "monthly KPI collection from portfolio companies", "limit": 10 }
    }
  }'