Shipfound MCP server

Shipfound

Your coding agent ships features. Shipfound makes it ship customers.

Shipfound turns Claude Code or Codex into your growth engineer. It checks what you have access to, fixes your site for Google and AI search, ships blog, glossary and comparison pages as pull requests, gets your pages indexed on Google and Bing, and installs tracking that shows when GPTBot, PerplexityBot and ClaudeBot read your pages and when ChatGPT sends you a visitor. The Shipfound server checks every result itself, and labels each one Verified or Claimed.

This repo is the plugin for both hosts: one skill with its routines, the /shipfound:* commands for Claude Code, the Codex plugin manifest, the MCP server config, and crawler beacon snippets. The data, verification and results app live at https://www.shipfound.co.

Install

Pick your agent. Both get the same skill, the same routines and the same remote MCP server, and both sign in once per machine.

Claude Code

claude plugin marketplace add shipfound/shipfound
claude plugin install shipfound@shipfound

Then open a new Claude Code session in your site's repo and run /shipfound:audit. From then on, start each day with /shipfound:grow: it checks what changed and what is still failing, then offers one move. The shell commands work for every Claude Code surface (terminal, VS Code, Cursor, desktop). In the terminal CLI you can also install from inside a session with /plugin marketplace add shipfound/shipfound and /plugin install shipfound@shipfound.

Sign in once: the first Shipfound command opens a sign-in page on shipfound.co in your browser. Pick your site and choose Allow; that session carries on, and every later session on this machine starts signed in. The plugin keeps a random secret for this machine in the macOS Keychain (elsewhere in ~/.config/shipfound/device, readable only by you) and sends it with each call; Shipfound keeps only its hash. To sign out on this machine, run sh scripts/device.sh forget from the plugin folder; to sign out everywhere, revoke the key in the results app (Settings, MCP connection).

Codex

codex plugin marketplace add shipfound/shipfound
codex plugin add shipfound@shipfound
codex mcp login shipfound

codex mcp login opens your browser to sign in (OAuth). Then start a new Codex thread in your site's repo and ask: "Run the Shipfound audit." From then on, start each day by asking: "What should I do today?" In the ChatGPT desktop app you can also install it from Plugins once the marketplace is added; it shows up under Shipfound.

Codex has no plugin slash commands, so you ask in words ("fix the site", "get us indexed", "status") and the skill runs the matching routine. To call the skill by name, type $shipfound:shipfound.

MCP server only (no plugin). If you would rather not install the plugin:

codex mcp add shipfound --url https://api.shipfound.co/mcp
codex mcp login shipfound

Then copy AGENTS.md into your repo. Full steps: docs/codex.md.

Sign in with an API key instead

For CI or a machine without a browser, make a key in the Shipfound app (Settings, MCP server; it starts with wl_). Each key carries a daily credit cap.

• Claude Code: add the server with the key as a fixed header, and use it in place of the plugin's server (turn that one off in /mcp; the skill and routines keep working):

claude mcp add --transport http shipfound-key https://api.shipfound.co/mcp --header "Authorization: Bearer $SHIPFOUND_API_KEY"

• Codex plugin: export SHIPFOUNDAUTHORIZATION="Bearer wl..." before starting Codex. The plugin sends it as the Authorization header; unset, OAuth is used.
• Codex, MCP server only: codex mcp add shipfound --url https://api.shipfound.co/mcp --bearer-token-env-var SHIPFOUNDAPIKEY, with SHIPFOUNDAPIKEY exported.

Point at another server

Shortened. The full README is on GitHub.