Bark MCP tools

MCP tool bark_list_leads

Returns the leads Bark matched to your services and locations, newest first by default. Each item has the credit cost and signals such as urgent, so you can decide before you spend anything. Reading a list spends no credits and notifies no customer.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "bark_list_leads",
    "arguments": {
      "view": "first_to_respond",
      "service": "Web Design",
      "max_credits": 15,
      "since": "2026-10-12",
      "sort": "credits",
      "limit": 20
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "leads": [
      {
        "lead_id": "61842207",
        "service": "Wedding Photography",
        "location": "Leeds, LS1",
        "credits": 12,
        "signals": [
          "urgent"
        ],
        "submitted": "2026-10-11"
      },
      {
        "lead_id": "61841930",
        "service": "Web Design",
        "location": "Manchester, M1",
        "credits": 9,
        "signals": [
          "first_to_respond"
        ],
        "submitted": "2026-10-11"
      }
    ]
  },
  "isError": false
}

MCP tool bark_get_lead

Returns the full request before you buy it: the customer's answers, location, credit cost, how many professionals have responded and the signals Bark shows. The customer's contact details stay hidden until contact_lead. Read only: no credits are spent.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "bark_get_lead",
    "arguments": {
      "lead_id": "lead_8c41d2"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "lead_id": "61842207",
    "service": "Wedding Photography",
    "location": "Leeds, LS1",
    "credits": 12,
    "responses_so_far": 2,
    "signals": [
      "urgent",
      "verified_phone"
    ],
    "answers": {
      "Event date": "2027-06-12",
      "Hours of coverage": "Full day"
    }
  },
  "isError": false
}

MCP tool bark_list_responses

Returns the leads you contacted, as in My Responses, with their status, the customer's contact details and your notes. Use status to see only the open ones. Read only.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "bark_list_responses",
    "arguments": {}
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "responses": [
      {
        "lead_id": "61842207",
        "service": "Wedding Photography",
        "customer": "Jordan",
        "status": "pending",
        "contacted": "2026-10-11",
        "note": "Sent estimate"
      },
      {
        "lead_id": "61790415",
        "service": "Kitchen Fitting",
        "customer": "Sam",
        "status": "pending",
        "contacted": "2026-10-08",
        "note": ""
      }
    ]
  },
  "isError": false
}

MCP tool bark_get_response

Returns one contacted lead with the customer's name, phone and email, the original request, the estimate you sent and the current status. Read only.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "bark_get_response",
    "arguments": {
      "lead_id": "lead_8c41d2"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "lead_id": "61842207",
    "status": "pending",
    "service": "Wedding Photography",
    "customer": {
      "name": "Jordan",
      "email": "client@example.com",
      "phone": "+44 7700 900123"
    },
    "estimate": {
      "amount": "450",
      "message": "Full day coverage, edited gallery included."
    }
  },
  "isError": false
}

MCP tool bark_get_credit_balance

Returns the credits available on your account now, as My Credits shows them. Read only.

Parameters

No parameters.

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "bark_get_credit_balance",
    "arguments": {}
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "credits": 88
  },
  "isError": false
}

MCP tool bark_list_invoices

Returns your Bark invoices with date, amount and a download link. Use since to limit the range. Read only.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "bark_list_invoices",
    "arguments": {}
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "invoices": [
      {
        "invoice_id": "INV-2026-0914",
        "date": "2026-09-14",
        "amount": "50.00",
        "download_url": "https://www.bark.com/invoices/example-0914.pdf"
      },
      {
        "invoice_id": "INV-2026-1002",
        "date": "2026-10-02",
        "amount": "100.00",
        "download_url": "https://www.bark.com/invoices/example-1002.pdf"
      }
    ]
  },
  "isError": false
}

MCP tool bark_get_lead_preferences

Returns the services, locations and coverage areas that decide which leads Bark sends you, from Lead Preferences in Settings. Read only.

Parameters

No parameters.

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "bark_get_lead_preferences",
    "arguments": {}
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "services": [
      "Web Design",
      "Wedding Photography"
    ],
    "locations": [
      {
        "place": "Leeds",
        "radius_miles": 25
      }
    ]
  },
  "isError": false
}

MCP tool bark_add_note

Adds a private note to a contacted lead. The customer is not told, so this tool does not ask for your OK, and you can change the note with another call.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "bark_add_note",
    "arguments": {
      "lead_id": "lead_8c41d2",
      "note": "note"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "lead_id": "61842207",
    "note": "Wants a second shooter",
    "saved": true
  },
  "isError": false
}

MCP tool bark_update_response_status

Moves a contacted lead to pending, hired or archived and returns the new status. A lead must be hired before request_review works. By default you confirm each call; you can switch that off for this tool.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "bark_update_response_status",
    "arguments": {
      "lead_id": "lead_8c41d2",
      "status": "pending"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "lead_id": "61790415",
    "status": "hired"
  },
  "isError": false
}

MCP tool bark_contact_lead

Spends credits to contact the lead and returns the customer's name, phone and email. Bark notifies the customer. Set max_credits and the call fails instead of buying a lead that costs more. By default you confirm each call; you can switch that off for this tool.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "bark_contact_lead",
    "arguments": {
      "lead_id": "61842207",
      "max_credits": 15
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "lead_id": "61842207",
    "status": "pending",
    "credits_spent": 12,
    "credits_left": 88,
    "service": "Wedding Photography",
    "location": "Leeds, LS1",
    "customer": {
      "name": "Jordan",
      "email": "client@example.com",
      "phone": "+44 7700 900123"
    }
  },
  "isError": false
}

MCP tool bark_skip_lead

Marks the lead Not interested. No credits are charged, and Bark tells the customer politely. By default you confirm each call; you can switch that off for this tool.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "bark_skip_lead",
    "arguments": {
      "lead_id": "lead_8c41d2"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "lead_id": "61841930",
    "status": "skipped",
    "credits_spent": 0
  },
  "isError": false
}

MCP tool bark_send_estimate

Sends a quote on a lead you already contacted. Bark notifies the customer. The amount is in your Bark currency. By default you confirm each call; you can switch that off for this tool.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "bark_send_estimate",
    "arguments": {
      "lead_id": "lead_8c41d2",
      "amount": "amount"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "lead_id": "61842207",
    "amount": "450",
    "message": "Full day coverage, edited gallery included.",
    "sent": true
  },
  "isError": false
}

MCP tool bark_send_message

Emails or texts a customer you already contacted, as free text in body or from one of your saved Email or SMS templates. Required: body or template. By default you confirm each call; you can switch that off for this tool.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "bark_send_message",
    "arguments": {
      "lead_id": "61842207",
      "channel": "sms",
      "template": "Follow-up"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "lead_id": "61842207",
    "channel": "sms",
    "sent": true
  },
  "isError": false
}

MCP tool bark_request_review

Invites the customer to review you on Bark. The lead must be marked hired first, otherwise the call fails. By default you confirm each call; you can switch that off for this tool.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "bark_request_review",
    "arguments": {
      "lead_id": "lead_8c41d2"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "lead_id": "61790415",
    "review_requested": true
  },
  "isError": false
}