All Flik MCP tools return JSON. Optional overrides for every tool: api_key, api_base_url, project, org.
Tool arguments use the same snake_case names as the HTTP API. For a complete field list (types, defaults, story vs bug, PATCH behavior), see Issue model.
Projects
| Tool |
Description |
| flik_list_projects |
List all projects the user has access to (optionally scoped by org). |
| flik_add_project |
Create a project. name (min 6 chars); 4-letter acronym is derived from the name. org required (or set in config). |
| flik_delete_project |
Delete a project and all records. acronym and confirm_acronym (must match) required. |
Users
| Tool |
Description |
| flik_list_users |
List users (org members) for the key's organization. Optional org override (or set FLIK_ORG in config). Returns user_id and name. |
Stories and bugs
| Tool |
Description |
| flik_list_stories |
List stories for a project (acronym). Optional assigned_to. |
| flik_list_bugs |
List bugs for a project. Optional assigned_to. |
| flik_get_object |
Get one story or bug by id (e.g. mypr-1). project required. |
| flik_add_story |
Create a story: project, title. Optional: status, assigned_to, priority, points, notes, description, acceptance_criteria, due_at, labels, component, external_ref, metadata (object), parent_id, blocks, blocked_by, sprint_id. |
| flik_add_bug |
Create a bug: project, title. Optional: status, assigned_to, priority, severity, description, steps_to_reproduce, expected, actual, environment, regression (bool), affected_version, fixed_in_version, plus shared fields as on stories. |
| flik_update_object |
Update by id. Pass only fields to change. Same JSON keys as the API (snake_case): e.g. title, assigned_to, status (open/in_progress/done/cancelled), priority, points, notes, severity, description, acceptance_criteria, steps_to_reproduce, expected, actual, environment, regression, affected_version, fixed_in_version, due_at, labels (array replaces list), blocks, blocked_by, parent_id, sprint_id, component, external_ref, metadata. |
| flik_delete_object |
Delete a story or bug by id. project and id required. |
Audit
| Tool |
Description |
| flik_get_logs |
List audit log entries (API transactions). Default: today only. all=true for full history. Optional project filter. |
Overrides
- api_key — Override the API key for this call.
- api_base_url — Override base URL (e.g.
http://localhost:8080).
- project — Override project acronym.
- org — Override org slug (needed for project create if not set in config).
Flik