linear_action

Interact with the Linear GraphQL API: list and search issues, create issues, get project details, and list teams.

SERVERUnClick SOURCE@unclick/mcp-server

Medium RISK CLASS

Category Write

Parameters 112 required

Recommended Rate-limitedsee the rule below

Registry record Grade F, identity unverified Pull the record →

This record as markdown: /tools/io-github-malamutemayhem-unclick-mcp-server/linear-action.md

WHAT IT DOES

What linear_action does on UnClick

AI agents use linear_action to create or update resources in UnClick, usually the action step of a workflow, after the agent has gathered context. Every call changes real data in your UnClick environment.

Parameter	Type	Required	Description
`first`	number	—	Number of results to return (default 25).
`query`	string	—	Search term (for search_issues).
`title`	string	—	Issue title (for create_issue).
`action`	string	Yes	Action: list_issues, create_issue, get_project, list_teams, search_issues.
`api_key`	string	Yes	Linear API key.
`team_id`	string	—	Team ID (required for create_issue, optional filter for list_issues).
`priority`	number	—	Priority: 0 (none), 1 (urgent), 2 (high), 3 (medium), 4 (low).
`state_id`	string	—	Workflow state ID.
`project_id`	string	—	Project ID (for get_project).
`assignee_id`	string	—	Assignee user ID.
`description`	string	—	Issue description.

Parameters from the server's own tool schema.

RISK

Why linear_action is rated Medium

The tool performs both read operations (list, search, get) and write operations (create issues). By the severity hierarchy, Write is more severe than Read. Creating issues is reversible (issues can be deleted or modified later), so it does not qualify as Destructive.

From the tool's definition Tool description explicitly states 'create issues' alongside read operations like 'list and search issues' and 'get project details'. Creating issues modifies data in the Linear project management system.

Risk signalsHandles credentials or secrets (api_key) · High parameter count (11 properties)

Attacks that exploit this kind of access

RECOMMENDED RULE

The rule that runs linear_action safely

PolicyLayer is an MCP gateway: it sits between your AI agents and UnClick, and checks every tool call against a rule you set before the call runs. Nothing changes on the server itself. For linear_action, this is the rule to start with:

linear_action Rate-limited

linear_action stays usable, but capped: an agent stuck in a loop can't make hundreds of changes a minute. Everything else on the server is denied unless you say otherwise.

View as policy code

policy.json

{
  "version": "1",
  "default": "deny",
  "tools": {
    "linear_action": {
      "limits": [
        {
          "counter": "linear_action_rate",
          "window": "minute",
          "max": 30,
          "scope": "grant"
        }
      ]
    }
  }
}

LIMIT THIS TOOL → Instant setup, no code required.

The button opens the PolicyLayer dashboard: create your workspace, connect UnClick, apply this rule, and every linear_action call is checked against it from then on.

FAQ

Questions about linear_action

What does the linear_action tool do? +

Interact with the Linear GraphQL API: list and search issues, create issues, get project details, and list teams. It is categorised as a Write tool in the UnClick MCP Server, which means it can create or modify data. Consider rate limits to prevent runaway writes.

What parameters does linear_action accept? +

linear_action accepts 11 parameters: first, query, title, action, api_key, team_id, priority, state_id, project_id, assignee_id, description. Required: action, api_key. The full parameter table on this page comes from the server's own tool schema.

How do I enforce a policy on linear_action? +

Register the UnClick MCP server in PolicyLayer and add a rule for linear_action: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches UnClick. Nothing to install.

What risk level is linear_action? +

linear_action is a Write tool with medium risk. Write tools should be rate-limited to prevent accidental bulk modifications.

Can I rate-limit linear_action? +

Yes. Add a rate_limit block to the linear_action rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.

How do I block linear_action completely? +

Set action: deny in the PolicyLayer policy for linear_action. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.

What MCP server provides linear_action? +

linear_action is provided by the UnClick MCP server (@unclick/mcp-server). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.

KEEP EXPLORING

More on UnClick, and thousands of servers like it.

This server

All 1662 UnClick tools →

Across the catalogue

The MCP Attack Database →

Guides

Govern customer-ops agents →Argument validation →Scoped token →