Contracko Skills MCP Server

Contracko skills

AI contract management MCP server by Contracko. Manage your business contracts with Claude, ChatGPT, Codex, Gemini, Copilot, Cursor, Grok, and other AI tools.

Contracko is a contract repository: PDFs and Word files in one workspace, with dates, values, parties, and AI analysis on top. These skills teach an assistant how to import, review, organise, and file that work. The MCP server is the live connection to your workspace.

No account yet? Start a 7-day free trial (no credit card). You can also create the trial account on the OAuth screen the first time you connect the server.

Security

Contracko does not train models on your contracts. Analysis inside the product runs under commercial API terms, with Zero Data Retention where we have it, and we work to get ZDR with every AI subprocessor. See Security.

Connecting this plugin is different: when Claude, ChatGPT, Codex, or another assistant calls Contracko, contract text is sent to that product. Contracko cannot control what they do with it. Turn off model training in that product before using real contracts.

Install

You connect your assistant to Contracko in two steps:

1. Add the skills (this repo) so it knows how to help with contracts.
2. Add the connection so it can reach your workspace. Paste this address when asked:

https://app.contracko.com/mcp

A browser window will open. Sign in to Contracko (or start the free trial there). Adding the skills does not connect the workspace on its own. If Contracko is already listed in that assistant, skip step 2.

When you sign in, tick Read so it can answer questions. Tick Write only if it should add or change contracts. Leave Write off unless you want that.

The canonical Agent Plugins v1 skills package is generated at packages/agent-plugin/. It is skills-only. Connect https://app.contracko.com/mcp through the host client's native MCP and OAuth flow.

Open the section for the product you use.

1. Download the skill files from Releases and add them in Claude.
2. Go to Settings → Connectors → Add custom connector.
3. Paste https://app.contracko.com/mcp.
4. Sign in in the browser that opens.

If Contracko already appears under Connectors, do not add it a second time.

1. In the workspace, go to Settings → Plugins → Import marketplace and enter contracko/contracko-skills.
2. Turn on Developer mode.
3. Go to Settings → Apps → Create and paste https://app.contracko.com/mcp.
4. Sign in in the browser that opens.

ChatGPT has no settings file for this. Use the screens above.

1. Open grok.com/connectors.
2. Add https://app.contracko.com/mcp.
3. Sign in in the browser that opens.

For Grok in the terminal, see Any other assistant below.

In Claude Code, run:

/plugin marketplace add https://github.com/contracko/contracko-skills.git
/plugin install contracko@contracko

Paste that full GitHub address (not a short owner/repo name). Then connect:

claude mcp add --transport http contracko https://app.contracko.com/mcp

Type /mcp in the session and sign in in the browser.

If you installed the older contracko-skills plugin, remove that plugin and install contracko@contracko after updating the marketplace. The GitHub repository remains contracko/contracko-skills; the MCP connection remains contracko.

npx skills@latest add contracko/contracko-skills
codex mcp add contracko --url https://app.contracko.com/mcp
codex mcp login contracko

Sign in in the browser that opens.

This repository includes a Cursor plugin manifest at .cursor-plugin/plugin.json. It bundles the four existing skills and the MCP connection in mcp.json; no API key is included. The plugin is not yet listed in the public Cursor Marketplace.

To test the plugin locally, clone this repository into ~/.cursor/plugins/local/contracko-skills, reload Cursor, and check Customize for the skills and MCP server. Connect Contracko and complete OAuth in the browser. Approve Read by default and Write only when needed. If you already added the same server manually, use one connection rather than enabling both.

For manual installation without the plugin:

npx skills@latest add contracko/contracko-skills

Then add this to .cursor/mcp.json in your project (create the file if it is not there):

{ "mcpServers": { "contracko": { "url": "https://app.contracko.com/mcp" } } }

Restart Cursor if it does not pick up the connection, then sign in in the browser.

npx skills@latest add contracko/contracko-skills

Then open the Cline panel, go to the Configure tab, and add this to the MCP settings JSON (the CLI reads ~/.cline/mcp.json):

{ "mcpServers": { "contracko": { "type": "streamableHttp", "url": "https://app.contracko.com/mcp" } } }

Sign in in the browser that opens. Set "type": "streamableHttp", because leaving it out falls back to the older SSE transport.

npx skills@latest add contracko/contracko-skills

Then add this to .vscode/mcp.json in your project:

{ "servers": { "contracko": { "type": "http", "url": "https://app.contracko.com/mcp" } } }

Sign in in the browser that opens.

npx skills@latest add contracko/contracko-skills

Then add this to ~/.gemini/settings.json:

{ "mcpServers": { "contracko": { "httpUrl": "https://app.contracko.com/mcp" } } }

Sign in in the browser that opens.

For the thin wrapper, download contracko-openclaw.zip, extract it, and install the directory through OpenClaw's normal bundle flow. The archive contains the four skills only. It does not register or authenticate an MCP server.

For a skills-only install, run npx skills@latest add contracko/contracko-skills.

If you already have the skills, use the native setup below. Check for an existing contracko entry first and do not add a second connection:

openclaw mcp set contracko '{"url":"https://app.contracko.com/mcp","transport":"streamable-http"}'
openclaw mcp configure contracko --auth oauth
openclaw mcp login contracko

Run those commands only after explicitly approving the new central entry. Sign in in the browser that opens and choose Read or Write scopes yourself.

For the thin wrapper, download contracko-hermes.zip, extract it, and install the directory through Hermes's normal plugin flow. Review and enable the package explicitly. The archive contains the four skills only. It does not write MCP configuration or credentials.

For a skills-only install, run npx skills@latest add contracko/contracko-skills.

If you already have the skills, check ~/.hermes/config.yaml for an existing mcp_servers.contracko entry first. If none exists, explicitly approve adding this entry while preserving the rest of the file:

mcp_servers:
  contracko:
    url: "https://app.contracko.com/mcp"
    auth: oauth

Run hermes mcp login contracko and sign in in the browser. Choose Read or Write scopes yourself.

These clients spawn a local process instead of opening the HTTP endpoint themselves:

npx -y @contracko/mcp

That package only launches the hosted server at https://app.contracko.com/mcp. It is not a second MCP implementation. Skills still install with npx skills add https://contracko.com.

Paste this into the assistant and let it follow the file:

Fetch and follow https://contracko.com/mcp/install/prompt.md

If you are adding the connection yourself, the address is still https://app.contracko.com/mcp. Sign in in a browser. Do not add Contracko twice if it is already connected.

Step-by-step recipes: agent-setup/prompt.md.

Usage

Once connected, talk to the assistant the way you would a colleague. These are the jobs people actually run:

Skills

Four playbooks. You do not have to pick one; asking in plain language is enough.

Get help

Want guidance on Contracko? Read the docs or contact us. That covers the product, your workspace, and anything else you want to talk through.

Have a question about these skills, a suggestion, or an improvement? Open a GitHub issue.

Contributing

Before publishing skill changes, run python3 -m unittest discover -s tests -v. See validation and catalog refresh and the workflow regression cases.

MIT licensed.