Docs

Generic MCP Client

Connect any MCP-compatible client to Shipchart. This page covers the connection details your client needs.

Connection details

Server URL https://shipchart.app/mcp
Transport Streamable HTTP (HTTP with SSE)
Authentication HTTP Bearer token via Authorization header
Token Generate in Settings → API Tokens

Config example

Most MCP clients use a JSON config file. The typical format is: 

{
  "mcpServers": {
    "shipchart": {
      "url": "https://shipchart.app/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}

Note: Some clients use serverUrl instead of url. Check your client's documentation.

Available tools

All 23 tools are available. Read tools need read, write tools need write, and the sync tool needs sync ability.

Read tools

  • dashboard_get — Portfolio summary
  • projects_list — List projects with filters
  • projects_get — Project detail
  • projects_get_context — Developer context for a project
  • revenue_list — Revenue entries
  • checkins_list — Check-ins
  • ideas_list — Ideas with scores
  • integrations_list — Integration status
  • goals_list_by_project — Goals for a project
  • goals_list — All goals across portfolio
  • goals_portfolio — Portfolio-level goals
  • expenses_list — Expenses with monthly totals
  • financials_summary — Revenue, expenses, and profit

Write tools

  • checkins_create — Record a check-in
  • revenue_create — Log revenue
  • projects_create — Create a project
  • projects_update — Update a project
  • ideas_create — Capture an idea
  • ideas_promote — Promote idea to project
  • goals_create — Set a project or portfolio goal
  • goals_update_progress — Update goal progress
  • expenses_create — Track an expense
  • integrations_sync — Manual integration sync (needs sync ability)

Prompts

  • weekly-review-prompt — Portfolio review with stale projects, revenue trends, and focus suggestions
  • project-health-check-prompt — Deep-dive on a specific project (takes project_name argument)
  • quick-capture-prompt — Rapid check-in session across all active projects
  • switch-project-prompt — Load full project context and get a briefing to start working
  • shipchart:init — Set up a project from codebase context (find/create + populate fields)
  • shipchart:discover-context — Refresh context fields for an existing project from codebase analysis

Resources

  • founder://dashboard — Portfolio summary snapshot
  • founder://projects/{id} — Project detail by ID
  • founder://projects/{id}/context — Full developer context for a project

Need help? Check the Claude Code guide for a more detailed walkthrough, including example interactions.