Sign up

API and MCP agents

Your agents read and update your cards. Your tools talk to 2T Bug through a documented API.

Sign upOpenAPI description

Connect an agent

2T Bug speaks the MCP protocol: Claude, Cursor or your own agent work on your cards, with permissions set project by project.

  1. Create a token

    My account, Developer access section. Pick the “AI assistants” scope and a validity period. The token is shown only once.

  2. Declare the server

    Replace YOUR_TOKEN with yours.

    Terminal
    claude mcp add --transport http 2t-bug https://api.2tbug.com/api/mcp \
  --header "Authorization: Bearer YOUR_TOKEN"

  3. Open your projects to the agent

    In each project’s settings, allow reading, and writing if the agent should create or edit cards. A closed project stays invisible to it.

What the agent can do

  • list_projectsThe projects open to the agent: columns, labels, people, and whether writing is allowed.
  • list_ticketsA project’s cards, filtered by status, type, epic, sprint, label, urgency or person; the trash too.
  • get_ticketEverything about a card: Markdown description, checklist, dependencies, attachments, time spent, comments.
  • get_ticket_historyA card’s history: who did what, and when.
  • searchThe app’s search, filters included: “assignee:me urgency:4+”.
  • list_sprintsA Scrum project’s sprints and their scope.
  • create_ticketCreates a complete card in one go: fields, epic, sprint, people, labels, checklist, dependencies.
  • update_ticketChanges the fields provided; adds or removes a person or a label without replacing them all.
  • move_ticketMoves a card to another column, position or sprint.
  • update_checklistAdds, ticks, unticks, renames or removes checklist items, in one call.
  • link_ticketsAdds a dependency: blocks, blocked by, relates to, duplicate of.
  • unlink_ticketsRemoves a dependency between two cards.
  • add_commentComments or replies; @mentions notify the people named.
  • update_commentEdits one of your comments.
  • delete_commentDeletes a comment (your own, or any comment for an admin).
  • add_attachmentAttaches a file (10 MB at most) or a text: screenshot, log, notes.
  • remove_attachmentRemoves an attachment.
  • log_timeLogs time spent: “1h30”.
  • delete_time_entryDeletes a time entry.
  • merge_duplicateMerges a duplicate into the original card.
  • delete_ticketMoves a card to the trash, restorable for 30 days.
  • restore_ticketTakes a card out of the trash.

The REST API

Every feature of the app, in JSON. The OpenAPI description is the reference: generate your client, or read it in your favorite tool.

Address
https://api.2tbug.com/api/v2
Authentication
Header Authorization: Bearer, with an “API” scope token
Format
JSON, ISO 8601 dates, UUID identifiers
Description
openapi.json
List your projects
curl https://api.2tbug.com/api/v2/projects \
  -H "Authorization: Bearer YOUR_TOKEN"

Good practices

  • One token per use, with the narrowest possible scope and an expiry date.
  • Never paste it into a code repository: use an environment variable.
  • An exposed token is revoked in one click, in My account. It stops working immediately.