Tines MCP Server

A Model Context Protocol (MCP) server for interacting with the Tines security automation platform.

Features

• Stories: List, create, update, delete, import/export stories

• Actions: Create, update, delete, and run actions within stories

• Credentials: Manage text and OAuth credentials

• Teams & Folders: Organize your Tines workspace

• Events: View story execution history

• Global Resources: Manage shared resources across stories

Related MCP server: tracecat-mcp-community

Security

• API tokens are stored in .env file (never committed to git)

• All API calls use HTTPS

• Error messages are sanitized to prevent token leakage

• Input validation on all parameters

Setup

1. Clone the Repository

git clone https://github.com/YOUR_USERNAME/tines-mcp-server.git
cd tines-mcp-server

2. Install Dependencies

pip install -r requirements.txt

3. Configure Credentials

Copy the example environment file:

cp .env.example .env

Edit .env with your Tines credentials:

TINES_TENANT=your-company.tines.com
TINES_API_TOKEN=your-api-token-here

To get your API token:

1. Log in to Tines

2. Go to your Profile (top-right corner)

3. Navigate to API Tokens

4. Create a new token with appropriate permissions

5. Copy the token immediately (it won't be shown again)

4. Configure Claude Desktop

Add this to your Claude Desktop config file:

Windows: %APPDATA%\Claude\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "tines": {
      "command": "python",
      "args": ["/path/to/tines-mcp-server/server.py"]
    }
  }
}

Note: Update the path to match your actual installation location.

5. Restart Claude Desktop

After configuring, restart Claude Desktop to load the MCP server.

Available Tools

Stories

Actions

Credentials

Teams & Folders

Events

Global Resources

Utilities

Drafts (Change Control)

For stories with Change Control enabled, use these tools to create, test, and publish changes safely:

Workflow for Change Control:

1. create_draft - Create a draft from the live story

2. create_draft_action / update_draft_action - Make your changes

3. run_draft_action - Test your changes

4. publish_draft - Push changes to live (or delete_draft to discard)

Common Action Types

When creating actions, use these type strings:

Example Usage

Once configured, you can ask Claude to:

• "List all my Tines stories"

• "Create a new story called 'Phishing Response'"

• "Add an HTTP Request action to story ID 123"

• "Show me the events for story 456"

• "Export story 789 so I can back it up"

License

MIT