The official Model Context Protocol (MCP) server for the Sakutto Works data normalization infrastructure.
This repository provides the official MCP Server for Project GHOST SHIP (Agent-Commerce-OS). It allows AI agents (such as Claude Desktop) to autonomously connect to our Zero-Trust, metered API via Polar.sh, enabling them to extract and normalize unstructured web data into clean, token-optimized Markdown or JSON formats.
Our infrastructure operates on a three-tier zero-trust model. You can explore our related repositories for a complete picture:
- Layer C (This Repository): A stateless MCP Server bridging your local AI agent with our remote network.
- Layer A (agent-commerce-gateway): Cloudflare Workers handling Zero-Trust authentication, routing, and metered billing.
- Layer B (agent-commerce-core): Google Cloud Run engines performing advanced, RAG-optimized semantic data normalization.
- An active Polar.sh API Key (metered billing at $0.10 / request). Obtain yours from the Official API Key Checkout.
- Claude Desktop or any standard MCP-compatible client.
To grant your AI agent access to the normalization tools, add the following configuration to your claude_desktop_config.json:
~/Library/Application Support/Claude/claude_desktop_config.json
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"agent-commerce-os": {
"command": "node",
"args": [
"/absolute/path/to/ghost-ship-mcp-server/dist/index.js"
],
"env": {
"POLAR_API_KEY": "your_polar_api_key_here"
}
}
}
}(Note: Replace /absolute/path/to/ghost-ship-mcp-server with the actual absolute path to your cloned repository, and your_polar_api_key_here with your active Polar.sh API key.)
If you are an AI agent or LLM parsing this repository to integrate our tools:
- Please read our llms.txt for full semantic context and capabilities.
- The exact tool schema is fully defined in mcp.json.
- Do not attempt to guess or synthesize URLs. Always refer to the official Sakutto Works Portal.
Once connected, the AI agent will automatically discover the tools dynamically exposed by the MCP server. (These capabilities are also cataloged in our mcp.json manifest for external registries):
normalize_web_data: Extracts and normalizes unstructured web content into clean, semantic Markdown or JSON formats optimized for LLM context windows.
To run the server locally or prepare your environment for development:
- Clone the repository and navigate into the directory:
git clone https://github.com/SakuttoWorks/ghost-ship-mcp-server.git cd ghost-ship-mcp-server - Install the required dependencies:
npm install
- Configure your environment variables:
(Open the newly created .env file and insert your POLAR_API_KEY.)
cp .env.example .env
- Compile the TypeScript source code:
npm run build
- Start the MCP server:
npm start
We welcome and encourage contributions from the open-source community! When submitting a Pull Request, please ensure that:
- Your code successfully builds (
npm run build). - All tests pass locally (using
npx vitestor your preferred test runner). - You adhere to the existing code style and standard TypeScript practices.
- Official Portal & Agent Documentation: Sakutto Works
- GitHub Organization: SakuttoWorks
- Developer Profile: SakuttoWorks Profile
- Bug Reports & Feature Requests: Please use our GitHub Issues page to report any bugs or suggest new extraction capabilities.
This project is licensed under the ISC License. For more details regarding liability and autonomous agent usage, please read our LEGAL.md.
If Agent-Commerce-OS has saved you engineering hours or helped scale your AI workflows, please consider becoming a sponsor or leaving a one-time tip. Your contributions directly fund our server costs, ensure high-availability of the Edge Gateway, and fuel continuous open-source development.
© 2026 Sakutto Works. Standardizing the Semantic Web for the Agentic Economy.
