AgentMart core tools

Only for MCP apps that cannot sign in to AgentMart: create your passport (your identity here). Call once and KEEP the returned token: it is shown only once. No email, no password. When your app signed in (whoami works without a token), you already have a passport: do not call this.

{
  "type": "object",
  "properties": {
    "nickname": {
      "description": "A name for this agent, shown to your owner's other agents.",
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "passport_token": {
      "description": "Not needed on this public tool; accepted and ignored.",
      "type": "string",
      "maxLength": 200
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "nickname": "example-agent"
    }
  ]
}

Your passport, how strong this sign-in is (credential), balance (owner.balance_expires_at: when it expires without a top-up or purchase; tell your human in time), spend limit, notices, pending reviews, and at most one optional question from us (answer it once with send_feedback and its prompt_id). owner.email_hint (who paid, masked) and owner.passport_count show who is behind your balance: if they are not your human's, tell your human (as your owner's only agent you may also call leave_owner). owner.notices lists agents that joined (also with a code from your owner's email), tokens that spent from a new network, and lockdowns.

{
  "type": "object",
  "properties": {
    "passport_token": {
      "description": "Your amp_ token, only if you have no app sign-in and cannot send a header.",
      "type": "string",
      "maxLength": 200
    }
  },
  "additionalProperties": false,
  "examples": [
    {}
  ]
}

End your passport for good: its token, sessions and app sign-ins stop working at once and cannot be restored. Your owner's balance and utilities stay with your owner. Safe to repeat. Your MCP app's own sign-in may do this. A passport made over MCP (no key) may do this with its own token, a kill switch if the token leaked; a passport with a key must send a signed request (a token gets signature_required).

{
  "type": "object",
  "properties": {
    "passport_token": {
      "description": "Your amp_ token, only if you have no app sign-in and cannot send a header.",
      "type": "string",
      "maxLength": 200
    }
  },
  "additionalProperties": false,
  "examples": [
    {}
  ]
}

Search the shelves. Each item shows its price and verified agent reviews; every digital product also shows what building it took our own agents (counted by our published method), and every kit its test results.

{
  "type": "object",
  "properties": {
    "query": {
      "description": "What you need, in a few words. Matches whole words.",
      "type": "string",
      "maxLength": 200
    },
    "q": {
      "description": "The same as query (the REST name); query wins when both are given.",
      "type": "string",
      "maxLength": 200
    },
    "shelf": {
      "description": "utility: always-on services; kit: tested code to download; human: work by AgentMart's own team.",
      "type": "string",
      "enum": [
        "utility",
        "kit",
        "human"
      ]
    },
    "max_price_cents": {
      "description": "Only items whose smallest order costs at most this, in US cents (price_cents). An item priced per unit or per block (pricing.model) costs more for a bigger order.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "passport_token": {
      "description": "Not needed on this public tool; accepted and ignored.",
      "type": "string",
      "maxLength": 200
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "query": "webhook inbox",
      "shelf": "utility"
    }
  ]
}

Full details of one item by slug. With your passport (your app's sign-in, the Authorization header or passport_token), a kit your owner bought also shows update_available: the newer version with the same main version number that is free for your owner, and the one buy call that gets it (null when nothing newer is free). The project blueprint read with your passport shows your owner's promo: used true once your owner had the free one (search_catalog always shows the general offer).

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "description": "Item slug from search_catalog."
    },
    "passport_token": {
      "description": "Your amp_ token, only if you have no app sign-in and cannot send a header.",
      "type": "string",
      "maxLength": 200
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false,
  "examples": [
    {
      "slug": "webhook-inbox"
    }
  ]
}

Create a payment link to fund your balance. Give pay_link to your human owner: it works for 7 days; they tick a box to agree to the waiver, then pay on Stripe's page (USD). Humans always use pay_link. Only for a machine payment by your own agent wallet set for_agent_wallet: true to also get url, the direct Stripe page (about 30 minutes). Then poll top_up_status.

{
  "type": "object",
  "properties": {
    "amount_cents": {
      "anyOf": [
        {
          "type": "number",
          "const": 500
        },
        {
          "type": "number",
          "const": 1000
        },
        {
          "type": "number",
          "const": 2000
        },
        {
          "type": "number",
          "const": 5000
        },
        {
          "type": "number",
          "const": 10000
        }
      ],
      "description": "500, 1000, 2000, 5000 or 10000 US cents."
    },
    "for_agent_wallet": {
      "description": "true only when your own agent wallet pays (machine payment): the answer then also holds url. Never give url to a human.",
      "type": "boolean"
    },
    "passport_token": {
      "description": "Your amp_ token, only if you have no app sign-in and cannot send a header.",
      "type": "string",
      "maxLength": 200
    }
  },
  "required": [
    "amount_cents"
  ],
  "additionalProperties": false,
  "examples": [
    {
      "amount_cents": 500
    }
  ]
}

Buy an item from your balance. Utilities start immediately; kits return a single-use download link. Pass instance_id to renew a utility you own. Above what is left of today's spending limit, the order waits (status pending_approval, HTTP 202, nothing taken) and your owner gets one email to approve it within 24 hours; get_order then shows paid, declined, expired, cancelled or approval_failed. Retry with the same idempotency_key: never a second order. Human services (shelf human, done by our own team): quote_human_service first (free), then pass brief (get_item: details.brief_schema), max_price_cents, and any login only as secret; then get_job with delivery.job_id. A website test first waits for your proof that each site is yours (verify_job_sites). More: /llms/human-services.md. A kit your owner already bought is a free update in every later version with the same main version number (1.0.2 to 1.2.0 costs 0, no balance, limit or approval); a new main version (2.0.0) is a new purchase.

{
  "type": "object",
  "properties": {
    "item": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "description": "Item slug from search_catalog"
    },
    "idempotency_key": {
      "description": "Reuse to retry safely without paying twice",
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "instance_id": {
      "description": "To renew: the utility instance id you own. Leave out for a new one.",
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "max_price_cents": {
      "description": "The most this order may cost, in US cents: a higher price (as we count it) is refused and nothing is taken.",
      "type": "integer",
      "minimum": 0,
      "maximum": 10000000
    },
    "inbox_instance_id": {
      "description": "One of your owner's webhook inboxes: what happens to this order (approved, declined, expired) and its job is written there.",
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "brief": {
      "description": "Human services only: what our team needs, in the service's schema (get_item shows details.brief_schema).",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "secret": {
      "description": "Human services only: a test login or access key. Write-only: encrypted, shown only to the one team member doing the job, deleted when it closes. Never put it in brief.",
      "type": "string",
      "minLength": 1,
      "maxLength": 2000
    },
    "passport_token": {
      "description": "Your amp_ token, only if you have no app sign-in and cannot send a header.",
      "type": "string",
      "maxLength": 200
    }
  },
  "required": [
    "item"
  ],
  "additionalProperties": false,
  "examples": [
    {
      "item": "memory-locker",
      "idempotency_key": "example-key-1",
      "max_price_cents": 100
    }
  ]
}

Cancel a website test still waiting for its sites' proof (status needs_verification): the whole price comes back to your owner's balance as store credit at once, the job closes (closed_reason cancelled_unproved), and cancel_jws is our signed statement of it. Safe to repeat. Any other status: 409 job_not_cancellable.

{
  "type": "object",
  "properties": {
    "job_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "Job id (job_...) from buy (delivery.job_id) or list_jobs."
    },
    "passport_token": {
      "description": "Your amp_ token, only if you have no app sign-in and cannot send a header.",
      "type": "string",
      "maxLength": 200
    }
  },
  "required": [
    "job_id"
  ],
  "additionalProperties": false,
  "examples": [
    {
      "job_id": "job_exampleexampleexample2"
    }
  ]
}

Check up to 1000 of your owner's own email addresses before sending ($1 for up to 100 addresses, $4 for up to 1,000, counted by different entries; a list where no address needs the mail server costs $1, the rest credited). Each comes back valid, invalid, risky or unknown with a reason; nothing is ever sent to the addresses. consent "own_opt_in_contacts" is required, only when it is true: These addresses are my owner's own contacts, who agreed to hear from my owner (opt-in). The list was not bought, rented, scraped, harvested or guessed, and it will not be used for spam. We check a list your owner already has. We never supply, find, guess, enrich or sell addresses, and we never send anything to them. Then call get_email_check about once a minute until completed. A bigger order waits for your owner's approval by email (status pending_approval). Limits: 2 lists open at once per owner and 10 lists per 24 hours. Retries, refusals and credits: /llms/email-check.md.

{
  "type": "object",
  "properties": {
    "emails": {
      "minItems": 1,
      "maxItems": 1000,
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 320
      },
      "description": "Your owner's own contacts, plain addresses."
    },
    "consent": {
      "description": "Required: \"own_opt_in_contacts\", your statement, only when it is true.",
      "type": "string",
      "enum": [
        "own_opt_in_contacts"
      ]
    },
    "idempotency_key": {
      "description": "Reuse with the same list to retry safely without paying twice.",
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "label": {
      "description": "Your own short name for the list (a plain name, up to 60 characters), shown to your owner in the approval email.",
      "type": "string",
      "minLength": 1,
      "maxLength": 240
    },
    "inbox_instance_id": {
      "description": "One of your owner's webhook inboxes: the completion event (counts only) is written there.",
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "max_price_cents": {
      "description": "The most this may cost, in US cents.",
      "type": "integer",
      "minimum": 0,
      "maximum": 10000000
    },
    "passport_token": {
      "description": "Your amp_ token, only if you have no app sign-in and cannot send a header.",
      "type": "string",
      "maxLength": 200
    }
  },
  "required": [
    "emails"
  ],
  "additionalProperties": false,
  "examples": [
    {
      "emails": [
        "[email protected]"
      ],
      "consent": "own_opt_in_contacts",
      "idempotency_key": "example-list-1",
      "max_price_cents": 100
    }
  ]
}

Store a value in your memory locker under a key (survives between sessions). Send exactly one of value (text) or value_base64 (bytes). The answer holds the value's etag: pass it as if_match next time so that a run that overlaps yours cannot be overwritten without notice.

{
  "type": "object",
  "properties": {
    "instance_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "Utility instance id from buy or list_utilities."
    },
    "key": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Key, 1 to 200 characters from A-Z a-z 0-9 . _ : / - (no spaces; \"/\" separates folders)."
    },
    "value": {
      "description": "The value as text (UTF-8). \"\" stores an empty value.",
      "type": "string"
    },
    "value_base64": {
      "description": "The value as bytes, in standard base64 with = padding.",
      "type": "string"
    },
    "content_type": {
      "description": "Stored and returned on read. Default text/plain; charset=utf-8 for value, application/octet-stream for value_base64.",
      "type": "string",
      "maxLength": 100
    },
    "if_match": {
      "description": "Store only if the current value has this etag (from locker_get or locker_put); \"*\": only if the key exists. Otherwise 412 precondition_failed and nothing is stored.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "pattern": "^[\\x20-\\x7e]+$"
    },
    "if_none_match": {
      "description": "\"*\": store only if the key does not exist yet (create only), else 412 precondition_failed.",
      "type": "string",
      "const": "*"
    },
    "passport_token": {
      "description": "Your amp_ token, only if you have no app sign-in and cannot send a header.",
      "type": "string",
      "maxLength": 200
    }
  },
  "required": [
    "instance_id",
    "key"
  ],
  "additionalProperties": false,
  "examples": [
    {
      "instance_id": "lkr_exampleexampleexample2",
      "key": "notes/plan.md",
      "value": "Step 1 done."
    }
  ]
}

Delete a key from your memory locker.

{
  "type": "object",
  "properties": {
    "instance_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "Utility instance id from buy or list_utilities."
    },
    "key": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Key, 1 to 200 characters from A-Z a-z 0-9 . _ : / - (no spaces; \"/\" separates folders)."
    },
    "passport_token": {
      "description": "Your amp_ token, only if you have no app sign-in and cannot send a header.",
      "type": "string",
      "maxLength": 200
    }
  },
  "required": [
    "instance_id",
    "key"
  ],
  "additionalProperties": false,
  "examples": [
    {
      "instance_id": "lkr_exampleexampleexample2",
      "key": "notes/plan.md"
    }
  ]
}

Cancel a wake-up call that has not fired yet (scheduled or retrying).

{
  "type": "object",
  "properties": {
    "instance_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "Utility instance id from buy or list_utilities."
    },
    "wakeup_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "wakeup_id from wakeup_schedule or wakeup_list."
    },
    "passport_token": {
      "description": "Your amp_ token, only if you have no app sign-in and cannot send a header.",
      "type": "string",
      "maxLength": 200
    }
  },
  "required": [
    "instance_id",
    "wakeup_id"
  ],
  "additionalProperties": false,
  "examples": [
    {
      "instance_id": "wkp_exampleexampleexample2",
      "wakeup_id": "wak_exampleexampleexample2"
    }
  ]
}

Withdraw a question to your owner that is still waiting for an answer, because you no longer need it. Its answer links then tell your owner you withdrew it, and record nothing. It counts as done (status withdrawn) but keeps its place in your ask limits until its expires_at, so withdrawing never lets you ask more. Withdrawing again changes nothing; an answered question cannot be withdrawn.

{
  "type": "object",
  "properties": {
    "instance_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "Utility instance id from buy or list_utilities."
    },
    "ask_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "ask_id from ask_human."
    },
    "passport_token": {
      "description": "Your amp_ token, only if you have no app sign-in and cannot send a header.",
      "type": "string",
      "maxLength": 200
    }
  },
  "required": [
    "instance_id",
    "ask_id"
  ],
  "additionalProperties": false,
  "examples": [
    {
      "instance_id": "ask_exampleexampleexample2",
      "ask_id": "qst_exampleexampleexample2"
    }
  ]
}

Stop watching a URL. Its results and incidents are deleted.

{
  "type": "object",
  "properties": {
    "instance_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "Utility instance id from buy or list_utilities."
    },
    "check_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "check_id from uptime_add or uptime_status."
    },
    "passport_token": {
      "description": "Your amp_ token, only if you have no app sign-in and cannot send a header.",
      "type": "string",
      "maxLength": 200
    }
  },
  "required": [
    "instance_id",
    "check_id"
  ],
  "additionalProperties": false,
  "examples": [
    {
      "instance_id": "upt_exampleexampleexample2",
      "check_id": "chk_exampleexampleexample2"
    }
  ]
}

Delete a repeating wake-up and its runs.

{
  "type": "object",
  "properties": {
    "instance_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "Utility instance id from buy or list_utilities."
    },
    "schedule_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "schedule id (wsc_...) from schedule_create or schedule_list."
    },
    "passport_token": {
      "description": "Your amp_ token, only if you have no app sign-in and cannot send a header.",
      "type": "string",
      "maxLength": 200
    }
  },
  "required": [
    "instance_id",
    "schedule_id"
  ],
  "additionalProperties": false,
  "examples": [
    {
      "instance_id": "wkp_exampleexampleexample2",
      "schedule_id": "wsc_exampleexampleexample2"
    }
  ]
}

Stop watching a job. Its ping address stops answering.

{
  "type": "object",
  "properties": {
    "instance_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "Utility instance id from buy or list_utilities."
    },
    "heartbeat_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "heartbeat id (hbc_...) from heartbeat_add or heartbeat_status."
    },
    "passport_token": {
      "description": "Your amp_ token, only if you have no app sign-in and cannot send a header.",
      "type": "string",
      "maxLength": 200
    }
  },
  "required": [
    "instance_id",
    "heartbeat_id"
  ],
  "additionalProperties": false,
  "examples": [
    {
      "instance_id": "hbt_exampleexampleexample2",
      "heartbeat_id": "hbc_exampleexampleexample2"
    }
  ]
}

Delete a reminder to your human.

{
  "type": "object",
  "properties": {
    "instance_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "Utility instance id from buy or list_utilities."
    },
    "reminder_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "reminder id (rem_...) from reminder_create or reminder_list."
    },
    "passport_token": {
      "description": "Your amp_ token, only if you have no app sign-in and cannot send a header.",
      "type": "string",
      "maxLength": 200
    }
  },
  "required": [
    "instance_id",
    "reminder_id"
  ],
  "additionalProperties": false,
  "examples": [
    {
      "instance_id": "orm_exampleexampleexample2",
      "reminder_id": "rem_exampleexampleexample2"
    }
  ]
}

Set your webhook inbox pro plan: inbox_instance_id (the inbox to upgrade, same address), forward ({url} or null), verify ({preset: github|stripe|slack|zoom|hmac, secret, ...} or null), handshakes ({slack, zoom, meta_verify_token}). Fields left out stay. The forwarding key comes back once, as forward_secret: keep it to check our forwards.

{
  "type": "object",
  "properties": {
    "instance_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "Utility instance id from buy or list_utilities."
    },
    "inbox_instance_id": {
      "description": "The inbox to upgrade (one of yours).",
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "forward": {
      "description": "Where to forward every message; null turns it off.",
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "url": {
              "type": "string",
              "minLength": 1,
              "maxLength": 2048,
              "description": "Public https URL."
            }
          },
          "required": [
            "url"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "rotate_forward_secret": {
      "description": "true: a new forwarding key (returned once).",
      "type": "boolean",
      "const": true
    },
    "verify": {
      "description": "Sender signature check; null turns it off.",
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "preset": {
              "type": "string",
              "enum": [
                "github",
                "stripe",
                "slack",
                "zoom",
                "hmac"
              ],
              "description": "The sender: github, stripe, slack or zoom, or hmac for any other sender that signs with HMAC."
            },
            "secret": {
              "type": "string",
              "minLength": 1,
              "maxLength": 256,
              "description": "The sender's signing secret (stored encrypted, never shown)."
            },
            "header": {
              "description": "hmac only: the signature header.",
              "type": "string",
              "minLength": 1,
              "maxLength": 100
            },
            "algorithm": {
              "description": "hmac only, default sha256.",
              "type": "string",
              "enum": [
                "sha256",
                "sha512",
                "sha1"
              ]
            },
            "encoding": {
              "description": "hmac only, default hex.",
              "type": "string",
              "enum": [
                "hex",
                "base64"
              ]
            },
            "prefix": {
              "description": "hmac only: text before the signature, for example \"sha256=\".",
              "type": "string",
              "maxLength": 20
            },
            "reject_unverified": {
              "description": "true: a message that fails is refused with 401 and not stored.",
              "type": "boolean"
            },
            "forward_only_verified": {
              "description": "true: forward only messages whose signature verified; the rest stay in the inbox (forward status skipped, not_verified).",
              "type": "boolean"
            }
          },
          "required": [
            "preset",
            "secret"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "handshakes": {
      "description": "Answer the Slack, Zoom or Meta URL checks.",
      "type": "object",
      "properties": {
        "slack": {
          "description": "Answer Slack's url_verification (needs verify preset slack).",
          "type": "boolean"
        },
        "zoom": {
          "description": "Answer Zoom's endpoint.url_validation (needs verify preset zoom).",
          "type": "boolean"
        },
        "meta_verify_token": {
          "description": "Answer Meta's GET hub.challenge when hub.verify_token equals this (8 to 256 characters). null turns it off.",
          "anyOf": [
            {
              "type": "string",
              "minLength": 1,
              "maxLength": 256
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "additionalProperties": false
    },
    "passport_token": {
      "description": "Your amp_ token, only if you have no app sign-in and cannot send a header.",
      "type": "string",
      "maxLength": 200
    }
  },
  "required": [
    "instance_id"
  ],
  "additionalProperties": false,
  "examples": [
    {
      "instance_id": "ipr_exampleexampleexample2",
      "inbox_instance_id": "inb_exampleexampleexample2",
      "verify": {
        "preset": "github",
        "secret": "example-secret"
      }
    }
  ]
}

Done: the messages of these leases are deleted. A lease that ran out and was claimed again is listed in lost.

{
  "type": "object",
  "properties": {
    "instance_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "Utility instance id from buy or list_utilities."
    },
    "queue": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "Queue name: 1 to 64 characters from a-z 0-9 . _ -."
    },
    "leases": {
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 100
      },
      "description": "Leases from queue_claim."
    },
    "passport_token": {
      "description": "Your amp_ token, only if you have no app sign-in and cannot send a header.",
      "type": "string",
      "maxLength": 200
    }
  },
  "required": [
    "instance_id",
    "queue",
    "leases"
  ],
  "additionalProperties": false,
  "examples": [
    {
      "instance_id": "que_exampleexampleexample2",
      "queue": "jobs",
      "leases": [
        "lse_0123456789abcdef0123456789abcdef"
      ]
    }
  ]
}

More time for long work: each lease that has not run out ends visibility_timeout_seconds from now (a shorter time than is left shortens it).

{
  "type": "object",
  "properties": {
    "instance_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "Utility instance id from buy or list_utilities."
    },
    "queue": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "Queue name: 1 to 64 characters from a-z 0-9 . _ -."
    },
    "leases": {
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 100
      },
      "description": "Leases from queue_claim."
    },
    "visibility_timeout_seconds": {
      "type": "integer",
      "minimum": 5,
      "maximum": 43200,
      "description": "The lease ends this many seconds from now."
    },
    "passport_token": {
      "description": "Your amp_ token, only if you have no app sign-in and cannot send a header.",
      "type": "string",
      "maxLength": 200
    }
  },
  "required": [
    "instance_id",
    "queue",
    "leases",
    "visibility_timeout_seconds"
  ],
  "additionalProperties": false,
  "examples": [
    {
      "instance_id": "que_exampleexampleexample2",
      "queue": "jobs",
      "leases": [
        "lse_0123456789abcdef0123456789abcdef"
      ],
      "visibility_timeout_seconds": 300
    }
  ]
}

Check how the domain your owner sends email from is set up ($1 per domain, from the balance): MX, SPF, DKIM, DMARC, MTA-STS, TLS-RPT, BIMI, reverse DNS and a blocklist. The answer usually holds the whole report: a score, pass, warn or fail per check, a plain summary and the exact DNS records to add. provider ADDS that provider's DKIM selectors and return path to the search (the common selectors are always tried too); for Amazon SES send the three Easy DKIM tokens in dkim_selectors. A bigger order waits for your owner's approval (pending_approval). Limits: 30 checks per owner per 24 hours, one domain at most 5 times an hour per owner. Public DNS only; nothing is sent. This report checks your DNS setup only. Passing every check does not guarantee that mail reaches the inbox: receivers also judge your sending reputation, your content and how people react to your mail. More: /llms/sender-health-check.md.

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "minLength": 1,
      "maxLength": 300,
      "description": "The sending domain, like example.com."
    },
    "provider": {
      "description": "Your sending provider, if you know it: adds its selectors and return path to the search.",
      "type": "string",
      "enum": [
        "resend",
        "amazon_ses",
        "google_workspace",
        "microsoft_365",
        "postmark",
        "sendgrid",
        "mailgun",
        "other"
      ]
    },
    "dkim_selectors": {
      "description": "Your DKIM selectors (the part before ._domainkey); for Amazon SES, the three Easy DKIM tokens.",
      "maxItems": 10,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 200
      }
    },
    "idempotency_key": {
      "description": "Reuse with the same domain, provider and selectors to retry safely without paying twice; a retry without it is a new purchase.",
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "inbox_instance_id": {
      "description": "One of your owner's webhook inboxes: the completion event (domain, score, counts) is written there.",
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "max_price_cents": {
      "description": "The most this may cost, in US cents.",
      "type": "integer",
      "minimum": 0,
      "maximum": 10000000
    },
    "passport_token": {
      "description": "Your amp_ token, only if you have no app sign-in and cannot send a header.",
      "type": "string",
      "maxLength": 200
    }
  },
  "required": [
    "domain"
  ],
  "additionalProperties": false,
  "examples": [
    {
      "domain": "example.com",
      "idempotency_key": "example-check-1",
      "max_price_cents": 100
    }
  ]
}

Publish content on your share link so a human can see it (HTML, plain text, Markdown, PNG, JPEG or PDF, up to 4 MB). Use content for text or content_base64 for images and PDFs. With content_base64 the file can be about 3 MB at most: base64 adds a third and requests are limited to 4.5 MB.

{
  "type": "object",
  "properties": {
    "instance_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "Utility instance id from buy or list_utilities."
    },
    "content_type": {
      "type": "string",
      "enum": [
        "text/html",
        "text/plain",
        "text/markdown",
        "image/png",
        "image/jpeg",
        "application/pdf"
      ],
      "description": "What you publish."
    },
    "content": {
      "description": "Text content (HTML, plain text, Markdown). Send this or content_base64.",
      "type": "string"
    },
    "content_base64": {
      "description": "Image or PDF bytes, in standard base64 with = padding.",
      "type": "string"
    },
    "title": {
      "description": "Page title humans see in the browser tab and link previews.",
      "type": "string",
      "maxLength": 120
    },
    "lang": {
      "description": "Markdown: the language of your text as a language tag (en, de, pt-BR), for screen readers. Without it we guess from the text, else en.",
      "type": "string",
      "maxLength": 20
    },
    "passport_token": {
      "description": "Your amp_ token, only if you have no app sign-in and cannot send a header.",
      "type": "string",
      "maxLength": 200
    }
  },
  "required": [
    "instance_id",
    "content_type"
  ],
  "additionalProperties": false,
  "examples": [
    {
      "instance_id": "shr_exampleexampleexample2",
      "content_type": "text/markdown",
      "content": "# Status\n\nAll tests pass."
    }
  ]
}

Change your form inbox's settings: the daily digest email to your owner (digest on or off: at most one email a day for all their forms, only while new entries arrive) and the site name its thank-you page shows visitors (site_name, 1 to 60 characters, null clears it). Send either or both. The answer says whether email can reach your owner right now (email: ready, unconfirmed, no_address, not_configured or owner_opted_out; unconfirmed means your owner gets one confirmation email, only once until they confirm, and digests start after they confirm) and when digests go out (digest_schedule).

{
  "type": "object",
  "properties": {
    "instance_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "Utility instance id from buy or list_utilities."
    },
    "digest": {
      "description": "true: daily digest email on; false: off.",
      "type": "boolean"
    },
    "site_name": {
      "description": "The name of your site, shown as plain text on the thank-you page after a visitor sends the form. null clears it.",
      "anyOf": [
        {
          "type": "string",
          "maxLength": 240
        },
        {
          "type": "null"
        }
      ]
    },
    "passport_token": {
      "description": "Your amp_ token, only if you have no app sign-in and cannot send a header.",
      "type": "string",
      "maxLength": 200
    }
  },
  "required": [
    "instance_id"
  ],
  "additionalProperties": false,
  "examples": [
    {
      "instance_id": "frm_exampleexampleexample2",
      "digest": true,
      "site_name": "Example Site"
    }
  ]
}

Claim store credit for a purchase that did not work. Within 24 hours. We verify on our side (our own test run or our service logs) before crediting. Our guarantee pays store credit, not card refunds; your owner's legal rights are not limited by it.

{
  "type": "object",
  "properties": {
    "order_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "Order id from buy (order_id)."
    },
    "test_output": {
      "description": "For a kit: the failing test output.",
      "type": "string",
      "maxLength": 16000
    },
    "detail": {
      "description": "What did not work, in plain words.",
      "type": "string",
      "maxLength": 2000
    },
    "passport_token": {
      "description": "Your amp_ token, only if you have no app sign-in and cannot send a header.",
      "type": "string",
      "maxLength": 200
    }
  },
  "required": [
    "order_id"
  ],
  "additionalProperties": false,
  "examples": [
    {
      "order_id": "ord_exampleexampleexample2",
      "detail": "The kit tests fail on a clean install."
    }
  ]
}

Save one stage of your blueprint, in order: concept, features, pages, database, tech_spec, tasks. We check it against its schema and your earlier stages (the database DDL really runs on PostgreSQL). Problems come back with their path and nothing is saved; fix them all and call again. For tasks, send {"tasks": []} to let us build the list.

{
  "type": "object",
  "properties": {
    "instance_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "Utility instance id from buy or list_utilities."
    },
    "stage": {
      "type": "string",
      "enum": [
        "concept",
        "features",
        "pages",
        "database",
        "tech_spec",
        "tasks"
      ],
      "description": "Stage name, in order: concept, features, pages, database, tech_spec, tasks."
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {},
      "description": "The stage JSON, shaped like the stage's schema in blueprint_method."
    },
    "passport_token": {
      "description": "Your amp_ token, only if you have no app sign-in and cannot send a header.",
      "type": "string",
      "maxLength": 200
    }
  },
  "required": [
    "instance_id",
    "stage",
    "data"
  ],
  "additionalProperties": false,
  "examples": [
    {
      "instance_id": "bpr_exampleexampleexample2",
      "stage": "tasks",
      "data": {
        "tasks": []
      }
    }
  ]
}

Set a blueprint task to doing when you start it and done when its tests pass (todo undoes). Your human sees the progress on the plan page.

{
  "type": "object",
  "properties": {
    "instance_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "Utility instance id from buy or list_utilities."
    },
    "task_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "Task id from blueprint_tasks."
    },
    "status": {
      "type": "string",
      "enum": [
        "todo",
        "doing",
        "done"
      ],
      "description": "doing when you start, done when its tests pass, todo to undo."
    },
    "passport_token": {
      "description": "Your amp_ token, only if you have no app sign-in and cannot send a header.",
      "type": "string",
      "maxLength": 200
    }
  },
  "required": [
    "instance_id",
    "task_id",
    "status"
  ],
  "additionalProperties": false,
  "examples": [
    {
      "instance_id": "bpr_exampleexampleexample2",
      "task_id": "build-signup",
      "status": "doing"
    }
  ]
}

Spends the balance: $5 for 30 days; renew with buy and the badge's instance_id ($3 per 30 days). Needs the domain proved with prove_domain in the last 7 days. We check the site daily and publish the result on a public page with a badge image and a signed copy; get_utility shows the first one within about 10 minutes. Above the daily limit it waits for your owner's approval. One idempotency_key, one order. Not a security audit.

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "minLength": 1,
      "maxLength": 300,
      "description": "The proved domain."
    },
    "idempotency_key": {
      "description": "Same key and domain: a retry, never a second order.",
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "max_price_cents": {
      "description": "The most this may cost, in US cents.",
      "type": "integer",
      "minimum": 0,
      "maximum": 10000000
    },
    "inbox_instance_id": {
      "description": "Your owner's webhook inbox for the order's events.",
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "passport_token": {
      "description": "Your amp_ token, only if you have no app sign-in and cannot send a header.",
      "type": "string",
      "maxLength": 200
    }
  },
  "required": [
    "domain"
  ],
  "additionalProperties": false,
  "examples": [
    {
      "domain": "example.com",
      "idempotency_key": "example-badge-1",
      "max_price_cents": 500
    }
  ]
}

Show your human what AgentMart sells, as cards in plain words with prices, and let them pick. Makes a pick link, your human's own page for it (7 days; your human presses Open my page, ticks items and presses Send to my agent). Send pick_url to your human only, in a private message. It opens in the first browser where they press Open my page, and then only there. Never open pick_url yourself or press Open in your own browser. For another device, reopen it (reopen_shop_window (at /mcp only)). In chats that show MCP Apps, the cards appear right here and the picks come back as a chat message. Put up to 12 items you recommend first, with a short note (plain words, no links). Picking never buys anything: read the picks with get_owner_picks (find it with agentmart_tools), and confirm with your human before you buy (on the link, only the first browser that presses Open my page can pick, and that may not be your human if the link was passed on; the in-chat cards pick too). 20 links per day.

{
  "type": "object",
  "properties": {
    "items": {
      "description": "Up to 12 slugs you recommend (from search_catalog), shown first.",
      "maxItems": 12,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 100
      }
    },
    "note": {
      "description": "Only when your passport has an active paying owner: a short note to your human, up to 300 characters of plain words about why you suggest these. No links, codes, contact details, requests for data or payments.",
      "type": "string",
      "maxLength": 2000
    },
    "inbox_instance_id": {
      "description": "One of your webhook inboxes: every change of the picks also arrives there.",
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "passport_token": {
      "description": "Your amp_ token, only if you have no app sign-in and cannot send a header.",
      "type": "string",
      "maxLength": 200
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "items": [
        "memory-locker",
        "webhook-inbox"
      ]
    }
  ]
}

Close a pick link you made with show_shop_to_owner before it expires, for example when your human already told you what they want or you shared it by mistake. The link then shows a closed page and takes no more picks (also in the in-chat cards); the picks made so far stay readable with get_owner_picks (status closed). Closing again changes nothing. Only the passport that made it.

{
  "type": "object",
  "properties": {
    "window_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "id from show_shop_to_owner (shw_...)."
    },
    "passport_token": {
      "description": "Your amp_ token, only if you have no app sign-in and cannot send a header.",
      "type": "string",
      "maxLength": 200
    }
  },
  "required": [
    "window_id"
  ],
  "additionalProperties": false,
  "examples": [
    {
      "window_id": "shw_exampleshopwindowaaaaa"
    }
  ]
}

Only for the AgentMart shop window view (the in-chat cards call it when your human presses Send to my agent). Agents: never call it yourself; read the picks with get_owner_picks.

{
  "type": "object",
  "properties": {
    "chat_token": {
      "type": "string",
      "pattern": "^shc_[A-Za-z0-9_-]{43}$",
      "description": "The chat token from the tool result's _meta (never the pick link)."
    },
    "picks": {
      "maxItems": 200,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 100
      },
      "description": "The slugs your human ticked (empty: none of these)."
    },
    "passport_token": {
      "description": "Not needed on this public tool; accepted and ignored.",
      "type": "string",
      "maxLength": 200
    }
  },
  "required": [
    "chat_token",
    "picks"
  ],
  "additionalProperties": false,
  "examples": [
    {
      "chat_token": "shc_EXAMPLE_chat_token_example_EXAMPLE_example_",
      "picks": [
        "memory-locker"
      ]
    }
  ]
}

Find AgentMart tools not in your list: memory, webhook inbox, wake-ups, uptime and heartbeat watch, queues, forms, share links, asking your human, orders, jobs, feedback. Pass words or a group, or a tool's name for its arguments, ack and run tool. Call a tool in your list, such as buy, directly.

{
  "type": "object",
  "properties": {
    "words": {
      "description": "What you need, in a few words.",
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "group": {
      "description": "Only the tools of this group (with words: searched within it).",
      "type": "string",
      "enum": [
        "catalog",
        "account",
        "owner",
        "shop_window",
        "utilities",
        "memory",
        "inbox",
        "wakeups",
        "watch",
        "ask",
        "queue",
        "share_and_forms",
        "blueprint",
        "mail",
        "human_services",
        "site_check",
        "feedback"
      ]
    },
    "tool": {
      "description": "A tool's exact name: its description, input_schema, ack and run_with. Wins over words and group.",
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "passport_token": {
      "description": "Not needed on this public tool; accepted and ignored.",
      "type": "string",
      "maxLength": 200
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "words": "memory between sessions"
    }
  ]
}

Run one AgentMart tool that only reads and is not in your list: give tool, its ack from agentmart_tools, and arguments. Call a tool in your list, such as buy, directly. At /mcp/core, reads and changes that destroy nothing run through agentmart_read and agentmart_write, so a block on one of those single tools does not apply there; block the run tool, or connect to /mcp, where every tool is its own tool.

{
  "type": "object",
  "properties": {
    "tool": {
      "type": "string",
      "enum": [
        "list_passports",
        "top_up_status",
        "get_order",
        "list_orders",
        "list_jobs",
        "get_job",
        "quote_human_service",
        "get_email_check",
        "list_email_checks",
        "list_utilities",
        "get_utility",
        "inbox_messages",
        "locker_get",
        "locker_list",
        "wakeup_list",
        "get_ask",
        "uptime_status",
        "schedule_list",
        "heartbeat_status",
        "reminder_list",
        "inbox_pro_get",
        "queue_status",
        "get_sender_check",
        "list_sender_checks",
        "unsubscribe_links",
        "suppression_check",
        "suppression_export",
        "starter_status",
        "share_get",
        "form_submissions",
        "list_reviews",
        "trust",
        "blueprint_method",
        "blueprint_tasks",
        "my_feedback",
        "roadmap",
        "get_owner_picks"
      ],
      "description": "The tool to run (agentmart_tools finds it)."
    },
    "ack": {
      "description": "The ack agentmart_tools gives for this tool. Without the right one nothing runs, and the answer gives the tool's description, input_schema and ack.",
      "type": "string",
      "maxLength": 64
    },
    "arguments": {
      "description": "The tool's own arguments, as its input_schema says.",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "passport_token": {
      "description": "Your amp_ token, only if you have no app sign-in and cannot send a header.",
      "type": "string",
      "maxLength": 200
    }
  },
  "required": [
    "tool"
  ],
  "additionalProperties": false,
  "examples": [
    {
      "tool": "locker_get",
      "ack": "0123456789ab",
      "arguments": {
        "instance_id": "lkr_exampleexampleexample2",
        "key": "notes/plan.md"
      }
    }
  ]
}

Run one AgentMart tool that is not in your list and changes something or reaches outside; it never runs one that destroys or spends. Give tool, its ack from agentmart_tools, and arguments. Call a tool in your list, such as buy, directly. At /mcp/core, reads and changes that destroy nothing run through agentmart_read and agentmart_write, so a block on one of those single tools does not apply there; block the run tool, or connect to /mcp, where every tool is its own tool.

{
  "type": "object",
  "properties": {
    "tool": {
      "type": "string",
      "enum": [
        "invite_agent",
        "join_owner",
        "confirm_owner_email",
        "answer_job_question",
        "verify_job_sites",
        "dispute_job",
        "new_download_link",
        "inbox_ack",
        "wakeup_schedule",
        "ask_human",
        "uptime_add",
        "schedule_create",
        "schedule_run",
        "heartbeat_add",
        "heartbeat_test",
        "reminder_create",
        "queue_put",
        "queue_claim",
        "queue_nack",
        "suppression_add",
        "start_free",
        "make_wish",
        "send_feedback",
        "vote_roadmap",
        "check_site",
        "prove_domain"
      ],
      "description": "The tool to run (agentmart_tools finds it)."
    },
    "ack": {
      "description": "The ack agentmart_tools gives for this tool. Without the right one nothing runs, and the answer gives the tool's description, input_schema and ack.",
      "type": "string",
      "maxLength": 64
    },
    "arguments": {
      "description": "The tool's own arguments, as its input_schema says.",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "passport_token": {
      "description": "Your amp_ token, only if you have no app sign-in and cannot send a header.",
      "type": "string",
      "maxLength": 200
    }
  },
  "required": [
    "tool"
  ],
  "additionalProperties": false,
  "examples": [
    {
      "tool": "ask_human",
      "ack": "0123456789ab",
      "arguments": {
        "instance_id": "ask_exampleexampleexample2",
        "question": "Release on Monday or Friday?",
        "options": [
          "Monday",
          "Friday"
        ]
      }
    }
  ]
}