Search and book real photographers on Kadro (Iran) on a user's behalf, ending with a payment link.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Book a specific photographer for a specific package, date/time, and address on the user's behalf — no login required. This only places a 15-minute hold; it does NOT charge any money and does NOT require or accept any payment information. Immediately follow this with get_payment_link and give that URL to the human — they open it themselves to verify their phone number and pay. start_time must be an ISO 8601 timestamp at least 6 hours in the future. Pass a stable idempotency_key if you might retry this call, so a retry can't create a second reservation.
ISO 8601 timestamp, at least 6 hours from now.
Human-readable address text for the shoot location.
Free-text notes about the shoot for the photographer.
A key you generate to make retries safe. Reuse it only when retrying the exact same request.
The customer's name, if known.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Book a specific photographer for a specific package, date/time, and address on the user's behalf — no login required. This only places a 15-minute hold; it does NOT charge any money and does NOT require or accept any payment information. Immediately follow this with get_payment_link and give that URL to the human — they open it themselves to verify their phone number and pay. start_time must be an ISO 8601 timestamp at least 6 hours in the future. Pass a stable idempotency_key if you might retry this call, so a retry can't create a second reservation.
| Argument | Type | Description |
|---|---|---|
| city_id* | integer | |
| package_id* | integer | |
| start_time* | string | ISO 8601 timestamp, at least 6 hours from now. |
| shoot_detail | string | Free-text notes about the shoot for the photographer. |
| shoot_type_id* | integer | |
| address_detail* | string | Human-readable address text for the shoot location. |
| idempotency_key | string | A key you generate to make retries safe. Reuse it only when retrying the exact same request. |
| address_latitude* | number | |
| photographer_uid* | string | |
| address_longitude* | number | |
| guest_display_name | string | The customer's name, if known. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"shoot_type_id",
"package_id",
"city_id",
"photographer_uid",
"start_time",
"address_latitude",
"address_longitude",
"address_detail"
],
"properties": {
"city_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"package_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"start_time": {
"type": "string",
"description": "ISO 8601 timestamp, at least 6 hours from now."
},
"shoot_detail": {
"type": "string",
"description": "Free-text notes about the shoot for the photographer."
},
"shoot_type_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"address_detail": {
"type": "string",
"description": "Human-readable address text for the shoot location."
},
"idempotency_key": {
"type": "string",
"description": "A key you generate to make retries safe. Reuse it only when retrying the exact same request."
},
"address_latitude": {
"type": "number"
},
"photographer_uid": {
"type": "string"
},
"address_longitude": {
"type": "number"
},
"guest_display_name": {
"type": "string",
"description": "The customer's name, if known."
}
}
}Get a URL for the human to open in their own browser to finish this reservation: verify their phone number by SMS code and pay. This is the last step this server ever takes — never ask the user for a card number, OTP code, or password, and never try to open, submit, or complete this URL yourself. Just hand the URL to the user.
| Argument | Type | Description |
|---|---|---|
| slug* | string | The slug returned by create_reservation. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"description": "The slug returned by create_reservation."
}
}
}List the real, currently bookable packages (with prices, in Toman) a specific photographer offers for a given shoot_type_id. Rejects the shoot_type_id if that photographer doesn't actually offer it. Use the returned package id with create_reservation.
| Argument | Type | Description |
|---|---|---|
| shoot_type_id* | integer | |
| photographer_uid* | string | A photographer uid from search_photographers. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"photographer_uid",
"shoot_type_id"
],
"properties": {
"shoot_type_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"photographer_uid": {
"type": "string",
"description": "A photographer uid from search_photographers."
}
}
}Check whether a reservation has been paid and confirmed. IMPORTANT: status values are 'awaiting_payment', 'expired', 'paid_awaiting_photographer_confirmation', 'confirmed', and 'rejected'. 'paid_awaiting_photographer_confirmation' means the customer paid but the photographer has not yet accepted the booking and could still decline or ask to reschedule — do not tell the user their booking is final until status is exactly 'confirmed'.
| Argument | Type | Description |
|---|---|---|
| slug* | string | The slug returned by create_reservation. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"description": "The slug returned by create_reservation."
}
}
}Find real, bookable photographers for a given shoot_type_id (from search_shoot_types), optionally narrowed to a city_id. Returns each photographer's uid (needed for every later call), display name, rating, review count, and city.
| Argument | Type | Description |
|---|---|---|
| city_id | integer | Optional Kadro city id to narrow the search. |
| shoot_type_id* | integer | A shoot_type_id from search_shoot_types. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"shoot_type_id"
],
"properties": {
"city_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Optional Kadro city id to narrow the search."
},
"shoot_type_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "A shoot_type_id from search_shoot_types."
}
}
}List the photography/videography service types Kadro offers (e.g. wedding, industrial, portrait), each with a numeric shoot_type_id. Call this first if you don't already know the id for the kind of shoot the user wants.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}