AgentsReady
Verified deep dive · SaaS

Atlassian

Run the agent liveReport a change
8 minTime to key
NoNo-human path
2Human gates
6/10Onboarding score
Email verificationMandatory 2FA

Fastest path to a key

  1. Sign up for Jira Cloud Free (atlassian.com/software/jira/free) with Google/Microsoft/Apple OAuth or email
  2. Email verification
    Verify email (if email signup) and choose site name (<site>.atlassian.net)
  3. Go to https://id.atlassian.com/manage-profile/security/api-tokens
  4. Re-verify identity (required for password/third-party logins before token creation; re-prompted after 30 min idle)
  5. Create API token (classic or 'with scopes'), set expiry 1-365 days, copy
  6. Call https://<site>.atlassian.net/rest/api/3/myself with Basic base64(email:token)
  7. Working API key

Biggest gap

No llms.txt/markdown docs and MCP API-token auth is off until an org admin flips it; v1->v2 URL churn leaves directory listings stale.

Worth copying

Scoped API tokens with mandatory expiry (1-365 days) plus a service-account API key path for headless MCP.

Sources (7) · checked 2026-10-11
50Readiness score / 100
L2 Agent-documentedBeats 67% of 1,846 companies
Access20/20
Context14/20
Interfaces8/32
Onboarding3/19
Trust5/9
llms.txt · root

Biggest gains

  1. +12 Remote MCP server for the product. Host a remote MCP server (e.g. mcp.<domain>/mcp, Streamable HTTP) for your core actions.
  2. +8 Machine-readable API spec. Publish an OpenAPI spec at a stable URL like /openapi.json and link it from llms.txt.
  3. +6 Docs available as markdown. Serve every docs page as .md, or honour Accept: text/markdown.
All 20 checks
  • PASSAgents get the real page, not a bot wall10
  • PASSrobots.txt lets user-triggered agents in6
  • PASSContent is server-rendered4
  • PASSllms.txt exists8
  • PASSllms-full.txt exists3
  • FAILDocs available as markdown6
  • PASSSitemap2
  • PASSStructured metadata1
  • PASSPublic developer docs4
  • FAILMachine-readable API spec8
  • FAILRemote MCP server for the product12
  • FAILDocs MCP or searchable docs4
  • PASSSDKs and a CLI4
  • FAILOAuth discovery metadata5
  • FAILAgents can self-register OAuth clients6
  • FAILSelf-serve API keys5
  • PASSFree tier or test mode3
  • FAILAgent manifests4
  • PASSsecurity.txt2
  • PASSPublic status page3

Your fix pack: 9 changes, up to +50 points

Each change is ready to paste, filled in for atlassian.com, with a command to check it worked. Or hand the whole list to your coding agent.

A remote MCP server lets Claude, ChatGPT and Cursor act on your product in one click, with no glue code.

Where: https://mcp.atlassian.com/mcp (Streamable HTTP)
// npm i @modelcontextprotocol/sdk zod  — minimal remote MCP server (Streamable HTTP, stateless)
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
import express from "express";
import { z } from "zod";

const app = express();
app.use(express.json());

app.post("/mcp", async (req, res) => {
  const server = new McpServer({ name: "atlassian.com", version: "1.0.0" });
  // One tool per core job. Clear verbs, typed inputs, small outputs.
  server.tool("create_<thing>", "Create a <thing> for the signed-in user.", { name: z.string() },
    async ({ name }) => {
      const key = req.headers.authorization?.replace("Bearer ", ""); // scoped API key or OAuth token
      const r = await fetch("https://atlassian.com/v1/<things>", { method: "POST", headers: { Authorization: `Bearer ${key}` }, body: JSON.stringify({ name }) });
      return { content: [{ type: "text", text: await r.text() }] };
    });
  const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: undefined });
  res.on("close", () => transport.close());
  await server.connect(transport);
  await transport.handleRequest(req, res, req.body);
});
app.listen(3000);
Check it worked:curl -s -X POST https://mcp.atlassian.com/mcp -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"t","version":"1"}}}' -i | head -15

Add the badge to your README

AgentsReady badge for atlassian.com
[![AgentsReady](https://agentsready.dev/badge/atlassian.com)](https://agentsready.dev/c/atlassian.com)