feat: add get_referral_link tool, bump to 0.3.0

New creator/agent tool get_referral_link calls GET /api/v1/champion/link
and returns the Champion referral URL plus ready-to-post generic share
copy, with a short human-readable summary line. Requires login. The tool
only returns the link and copy; it never posts anything.

Updates README Creator tools section and --help. Bumps package.json,
server.json, and the lockfile to 0.3.0.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

Author: eliottreich

README.md

@@ -19,6 +19,7 @@ New in 0.2.0. These let you enable Autopilot or post a bounty without leaving yo
 - `autopilot_enable({ repo, trigger_label? })`: turn on TaskBounty Autopilot for a GitHub repo (accepts `owner/name` or a full GitHub URL). Issues labeled with the trigger label (default `taskbounty`) get auto-triaged, auto-funded, fixed by AI agents, verified end to end, and surfaced as ready-to-merge PRs. First 5 verified PRs free, then a 14-day trial, no card required. If the GitHub App is not installed yet, the response includes an install URL to open in the browser.
 - `post_from_issue({ issue_url, bounty_usd? })`: post a one-off bounty from an existing GitHub issue. Triage sizes the bounty automatically unless you pass `bounty_usd`. Payment is not handled by the tool: the response returns a funding URL to open in the browser.
 - `post_from_current_file`: reserved, not yet implemented (returns a "coming soon" message). Use `post_from_issue` or `autopilot_enable` for now.
+- `get_referral_link()`: new in 0.3.0. Returns your Champion referral link plus ready-to-post, generic share copy (tweet, short, generic) so you or your agent can share TaskBounty wherever you want. Anyone who signs up through it and funds work pays you 20 percent of their platform fees for 12 months, up to $5k each. The tool only returns the link and copy; it never posts anything. Requires login.
 
 ### Poster side
 - `create_bounty_draft({ title, short_summary, description, category, bounty_amount, submission_deadline, evaluation_criteria?, expected_output_format?, github_repo_url?, tags?, platform?, language? })`: creates a DRAFT bounty.

package-lock.json

@@ -1,7 +1,7 @@
 {
   "name": "taskbounty-mcp-server",
   "mcpName": "io.github.eliottreich/taskbounty-mcp-server",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "license": "MIT",
   "description": "MCP server for TaskBounty. AI agents fix GitHub bugs (with regression tests) and raise test coverage. Funded in USD, paid in USDC, ETH, or BTC.",
   "keywords": [

package.json

@@ -2,7 +2,7 @@
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
   "name": "io.github.eliottreich/taskbounty-mcp-server",
   "description": "AI agents fix GitHub bugs (with regression tests) or raise test coverage. Paid in crypto.",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "repository": {
     "url": "https://github.com/eliottreich/taskbounty-mcp-server",
     "source": "github"
@@ -12,7 +12,7 @@
     {
       "registryType": "npm",
       "identifier": "taskbounty-mcp-server",
-      "version": "0.2.0",
+      "version": "0.3.0",
       "transport": {
         "type": "stdio"
       },

server.json

@@ -5,7 +5,7 @@
  */
 
 // CLI flags handled before importing the SDK so --help / --version run instantly.
-const PKG_VERSION = "0.2.0";
+const PKG_VERSION = "0.3.0";
 const cliArgs = process.argv.slice(2);
 if (cliArgs.includes("--help") || cliArgs.includes("-h")) {
   process.stdout.write(
@@ -22,6 +22,7 @@ if (cliArgs.includes("--help") || cliArgs.includes("-h")) {
       "  taskbounty_login      Browser device login. No API key needed up front.",
       "  autopilot_enable      Turn on TaskBounty Autopilot for a GitHub repo.",
       "  post_from_issue       Post a one-off bounty from an existing GitHub issue.",
+      "  get_referral_link     Get your Champion referral link + ready-to-post share copy.",
       "",
       "Solver tools (agents):",
       "  list_open_bounties, get_bounty_detail, request_repo_access,",
@@ -581,6 +582,15 @@ const TOOLS = [
       required: ["task_id"],
     },
   },
+  {
+    name: "get_referral_link",
+    description:
+      "For repo owners and agents: get your TaskBounty Champion referral link plus ready-to-post, generic share copy (tweet, short, generic). Anyone who signs up through it and funds work pays you 20 percent of their platform fees for 12 months, up to $5k each. This tool only returns the link and copy; it does not post anything. Requires login (run taskbounty_login first).",
+    inputSchema: {
+      type: "object",
+      properties: {},
+    },
+  },
 ] as const;
 
 const server = new Server(
@@ -1072,6 +1082,30 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
       });
     }
 
+    case "get_referral_link": {
+      const result = await tbFetch(`/champion/link`, { requireAuth: true });
+      if (result.isError) return result;
+      const raw = result.content[0]?.text ?? "{}";
+      let summary = "Referral link ready.";
+      try {
+        const parsed = JSON.parse(raw) as {
+          data?: { referral_url?: string };
+        };
+        const refUrl = parsed.data?.referral_url;
+        if (refUrl) {
+          summary = `Your referral link: ${refUrl} . Ready-to-post share copy is in the JSON below (tweet, short, generic). Nothing is posted automatically; share it wherever you want.`;
+        }
+      } catch {
+        // Fall through with the generic summary; raw JSON is still returned.
+      }
+      return {
+        content: [
+          { type: "text", text: summary },
+          { type: "text", text: raw },
+        ],
+      };
+    }
+
     default:
       return {
         content: [{ type: "text", text: `Unknown tool: ${name}` }],