home / mcp / contraption company mcp server

Contraption Company MCP Server

An experimental MCP server for Contraption Company essays

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "contraptionco-mcp": {
      "url": "https://mcp.contraption.co"
    }
  }
}

You can access the Contraption Company MCP Server to query and retrieve posts and pages from the Contraption Company blog through a remote MCP endpoint. This hosted server requires no authentication, making it quick to connect from your preferred MCP client and start exploring content right away.

How to use

To use the Contraption Company MCP Server, connect your MCP-enabled client to the remote endpoint and start issuing queries to search or fetch content. The server indexes public and members-only content and keeps itself up to date through automatic background syncing.

How to install

Prerequisites: you should have a client that supports MCP and a network route to the server URL.

Use the provided MCP URL to configure your client. For example, you can install or configure the MCP connection in several common clients as shown below.

{
  "mcpServers": {
    "contraption-company": {
      "url": "https://mcp.contraption.co"
    }
  }
}

Available tools

search

Search posts and pages by query text to quickly locate content across the Contraption Company blog.

indexing

Automatic indexing that syncs with the blog API on startup and via scheduled polling to keep content current.

content_access

Full access to published content, including members-only posts and pages, through MCP queries.

background_updates

Background polling of the Ghost blog to detect new, updated, or deleted content and reflect changes.

query_logging

Record search activity in a dedicated data collection for analysis and auditing.

docker_ready

Docker deployment support with a ready-to-use Dockerfile for easy deployment.

tests

Comprehensive test suite ensuring functionality and reliability through pytest.