Shipshape Data docs

Official3 tools

by shipshapedata · JavaScript

Docs Q&A: search 169 data and AI guides, fetch any page as markdown. Read-only, keyless.

com.shipshapedata/shipshape-data-docs MCP Server

The com.shipshapedata/shipshape-data-docs server provides docs Q&A over Shipshape Data’s public content. It can search 169 data and AI guides and fetch any page as Markdown. It is read-only and keyless, wrapping a keyless, read-only surface that exposes a public API, two MCP servers, and “markdown twins” of the site.

🛠️ Key Features

Docs Q&A search for 169 data and AI guides
Fetches any page as Markdown
Read-only, keyless access
Part of Shipshape Data’s keyless, read-only surface

🚀 Use Cases

Finding relevant guidance across 169 data and AI guides
Retrieving specific documentation pages in Markdown format

⚡ Developer Benefits

Markdown output suitable for developer workflows
Works without keys (keyless)
Organized alongside a public API and companion MCP servers

⚠️ Limitations

Read-only access (no publishing or edits)
Described as wrapping public API/doc sources only

Topics

agent-skillsai-readinessllms-txtmcp

Captured live from the server via tools/list.

search_docs

Search Shipshape Data's documentation: 169 practical guides on data and AI plus the service and industry pages. Results include the questions each page answers and its URL.

Parameters2

query	string	required	What you want to know, e.g. "what is data lineage"
limit	integer	optional	Max results, default 5

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "What you want to know, e.g. \"what is data lineage\""
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25,
      "description": "Max results, default 5"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

get_page

Fetch the full markdown twin of any shipshapedata.com page (articles, services, industries, case studies). Pass the page URL or path, e.g. "/resources/data-architecture/data-cleaning/".

Parameters1

url

string

required

Page URL or absolute path on shipshapedata.com

Raw schema

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "Page URL or absolute path on shipshapedata.com"
    }
  },
  "required": [
    "url"
  ],
  "additionalProperties": false
}

list_sections

The site's sections and resource categories with article counts, for orientation before searching. Pass a category name to list every guide in it.

Parameters1

Shipshape Data agent tools

The official agent toolkit for Shipshape Data, the London AI consultancy that builds the data foundation first. Everything here wraps the same keyless, read-only surface: the public API, two MCP servers, and the site's markdown twins.

What's in here

Path	What it is
`skills/`	Agent skills: install with `npx skills add shipshapedata/agent-tools`
`packages/cli/`	`shipshape-data` on npm: CLI (`npx shipshape-data readiness`) and Node SDK
`packages/python/`	`shipshape-data` on PyPI: `shipshape` CLI and Python SDK
`.mcp.json`, `.cursor/`	Drop-in MCP configs for Claude Code and Cursor
`plugin.json`	Claude Code plugin manifest (MCP servers + skills)

The surface it talks to

API: https://shipshapedata.com/api/v1 (self-describing; OpenAPI 3.1 spec)
MCP: https://shipshapedata.com/mcp (services, case studies, resource search, AI readiness scoring) and https://shipshapedata.com/mcp/docs (docs Q&A, full markdown of any page)
NLWeb: POST https://shipshapedata.com/ask
A2A: agent card
Guides: llms.txt | agents.md | developers

No auth anywhere, no write endpoints anywhere, fair use 300 requests/minute/IP.

Quick start

bash

# MCP in Claude Code
claude mcp add --transport http shipshape-data https://shipshapedata.com/mcp

# Skills
npx skills add shipshapedata/agent-tools

# CLI
npx shipshape-data readiness
pip install shipshape-data && shipshape search data lineage

Why this exists

We tell clients their AI is only as good as the data foundation underneath it, and that their products should be as easy for agents to use as for people. This repo is us doing it to ourselves. If you want your product to work like this, talk to us.

Install

Tools (3)

search_docsget_pagelist_sections

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://shipshapedata.com/mcp/docs

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "shipshape-data-docs": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://shipshapedata.com/mcp/docs"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.