Skip to main content
Glama

Share a website, app, agent, or skill by email

share_service
Destructive

Share a website, app, agent, or skill by email: each address is mailed a link, whatever the service's access mode, and sharing does not change who else can reach it. The link comes from Valet and opens the service; the recipient needs no Valet account of their own, only the link, so anyone holding the email can open it and forwarding it forwards access. On a website that holds a connector, the recipient's pages can call the connector's tools. An app runs server code, so a person it is shared with can use everything the app does, including anything that changes data. An agent can be shared only on a server with agent outside access turned on. Sharing again with an address that already has access re-sends the same link rather than creating a second one. Returns one result per address: its share id, whether the share was created or resent, and whether the mail went out. A share is recorded even when the mail fails. Requires connecting a Valet account.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "name": "<name>",
      "emails": "<emails>"
    },
    "name": "share_service"
  }
}

Input Schema

NameRequiredDescriptionDefault
kindNoThe kind you believe the named service is, as a safeguard against sharing the wrong thing. Omit to share whatever the name holds.
nameYesThe website's, app's, agent's, or skill's name, as list_services shows it: the one to share.
emailsYesWho receives the link, one email address each.
messageNoA note to the recipients, quoted in the email beside the link, so they know why they were sent it before they open it, such as what you want them to look at.
org_nameNoThe Valet organization the website, app, agent, or skill belongs to. Omit to use the organization the account joined first.
access_ttlNoHow long access lasts once the link is first opened, after which the link stops working, such as 30m or 7d. Omit for access that never expires this way. Composes with expires_in: the unopened deadline governs until the first open replaces it.
expires_inNoHow long from now the link works if nobody has opened it yet, such as 24h or 7d. Omit for a link that never expires this way.

Output Schema

NameRequiredDescriptionDefault
orgYesName of the Valet organization the call acted in.
kindYesKind of the service shared: site, app, agent, or skill.
nameYesName of the website, app, agent, or skill that was shared.
resultsYesOne entry per address, in the order the call named them.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / emails / description
      Previous value: -"The email addresses to share it with. An address that already has access is sent the same link again."New value: +"Who receives the link, one email address each."
  2. Changed1 schema field changed
    • changedInput schema / properties / message / description
      Previous value: -"A personal note from you, quoted in the email beside the link, such as why you are sharing it."New value: +"A note to the recipients, quoted in the email beside the link, so they know why they were sent it before they open it, such as what you want them to look at."
  3. Changed1 schema field changed
    • changedInput schema / properties / kind / description
      Previous value: -"The kind you expect the name to hold. A guard against sharing the wrong thing: a name that holds another kind is refused and nothing is sent. Omit to share whatever the name holds."New value: +"The kind you believe the named service is, as a safeguard against sharing the wrong thing. Omit to share whatever the name holds."
  4. Changed2 schema fields changed
    • changedInput schema / properties / kind / description
      Previous value: -"The kind you mean to share, as a guard: a name that holds another kind is refused and nothing is sent. Omit to share whatever the name holds."New value: +"The kind you expect the name to hold. A guard against sharing the wrong thing: a name that holds another kind is refused and nothing is sent. Omit to share whatever the name holds."
    • changedInput schema / properties / name / description
      Previous value: -"The website's, app's, agent's, or skill's name."New value: +"The website's, app's, agent's, or skill's name, as list_services shows it: the one to share."
  5. Changed1 schema field changed
    • changedOutput schema / properties / kind / description
      Previous value: -"Kind of the thing shared: site, app, agent, or skill."New value: +"Kind of the service shared: site, app, agent, or skill."
  6. Changed2 schema fields changed
    • changedInput schema / properties / kind / description
      Previous value: -"Omit to share whatever the name holds; give it to have a name holding another kind refused."New value: +"The kind you mean to share, as a guard: a name that holds another kind is refused and nothing is sent. Omit to share whatever the name holds."
    • changedInput schema / properties / message / description
      Previous value: -"A note included in the email, shown to the recipient as a quote beside the link."New value: +"A personal note from you, quoted in the email beside the link, such as why you are sharing it."
  7. Changed19 schema fields changed
    • changedInput schema / properties / access_ttl / description
      Previous value: -"How long the first open starts access for, after which the link stops working, such as 30m or 7d (units: s, m, h, d). Omit for access that never expires this way. Composes with expires_in: the unopened deadline governs until the first open replaces it."New value: +"How long access lasts once the link is first opened, after which the link stops working, such as 30m or 7d. Omit for access that never expires this way. Composes with expires_in: the unopened deadline governs until the first open replaces it."
    • addedInput schema / properties / access_ttl / pattern
      Added value: +"^[0-9]+[smhd]$"
    • changedInput schema / properties / emails / description
      Previous value: -"Required. The email addresses to share it with, at most 10 at a time. Sharing again with an address that already has access re-sends the same link rather than creating a second one."New value: +"The email addresses to share it with. An address that already has access is sent the same link again."
    • addedInput schema / properties / emails / maxItems
      Added value: +10
    • changedInput schema / properties / expires_in / description
      Previous value: -"How long from now the link works if nobody has opened it yet, such as 24h or 7d (units: s, m, h, d). Omit for a link that never expires this way."New value: +"How long from now the link works if nobody has opened it yet, such as 24h or 7d. Omit for a link that never expires this way."
    • addedInput schema / properties / expires_in / pattern
      Added value: +"^[0-9]+[smhd]$"
    • changedInput schema / properties / kind / description
      Previous value: -"The kind you mean. Omit to share whatever the name holds; give it to have a name holding another kind refused."New value: +"Omit to share whatever the name holds; give it to have a name holding another kind refused."
    • changedInput schema / properties / message / description
      Previous value: -"An optional note included in the email, shown to the recipient as a quote beside the link. At most 500 characters."New value: +"A note included in the email, shown to the recipient as a quote beside the link."
    • addedInput schema / properties / message / maxLength
      Added value: +500
    • changedInput schema / properties / name / description
      Previous value: -"Required. The website's, app's, agent's, or skill's name."New value: +"The website's, app's, agent's, or skill's name."
    • addedOutput schema / properties / kind / description
      Added value: +"Kind of the thing shared: site, app, agent, or skill."
    • addedOutput schema / properties / name / description
      Added value: +"Name of the website, app, agent, or skill that was shared."
    • addedOutput schema / properties / org / description
      Added value: +"Name of the Valet organization the call acted in."
    • addedOutput schema / properties / results / description
      Added value: +"One entry per address, in the order the call named them."
    • addedOutput schema / properties / results / items / properties / email / description
      Added value: +"The email address this entry reports on."
    • addedOutput schema / properties / results / items / properties / email_error / description
      Added value: +"Why the mail did not go out. Absent when it did. The share is recorded either way."
    • addedOutput schema / properties / results / items / properties / emailed / description
      Added value: +"True when the mail went out. When false, read email_error."
    • addedOutput schema / properties / results / items / properties / share_id / description
      Added value: +"Id of the share granted to this address."
    • addedOutput schema / properties / results / items / properties / state / description
      Added value: +"created when the address got a new share, resent when it already had one and the link was mailed again."
  8. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "additionalProperties": false,
      +  "properties": {
      +    "kind": {
      +      "type": "string"
      +    },
      +    "name": {
      +      "type": "string"
      +    },
      +    "org": {
      +      "type": "string"
      +    },
      +    "results": {
      +      "items": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "email": {
      +            "type": "string"
      +          },
      +          "email_error": {
      +            "type": "string"
      +          },
      +          "emailed": {
      +            "type": "boolean"
      +          },
      +          "share_id": {
      +            "type": "string"
      +          },
      +          "state": {
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "email",
      +          "share_id",
      +          "state",
      +          "emailed"
      +        ],
      +        "type": "object"
      +      },
      +      "type": [
      +        "null",
      +        "array"
      +      ]
      +    }
      +  },
      +  "required": [
      +    "org",
      +    "name",
      +    "kind",
      +    "results"
      +  ],
      +  "type": "object"
      +}
  9. Changed3 schema fields changed
    • changedInput schema / properties / kind / enum
      Previous value: -[
      -  "site",
      -  "app",
      -  "skill"
      -]New value: +[
      +  "site",
      +  "app",
      +  "agent",
      +  "skill"
      +]
    • changedInput schema / properties / name / description
      Previous value: -"Required. The website's, app's, or skill's name."New value: +"Required. The website's, app's, agent's, or skill's name."
    • changedInput schema / properties / org_name / description
      Previous value: -"The Valet organization the website, app, or skill belongs to. Omit to use the organization the account joined first."New value: +"The Valet organization the website, app, agent, or skill belongs to. Omit to use the organization the account joined first."
  10. Changed3 schema fields changed
    • changedInput schema / properties / kind / description
      Previous value: -"The kind you mean. Omit to share whatever the name holds; give it to have a name holding another kind refused. Only a website or a skill can be shared by email."New value: +"The kind you mean. Omit to share whatever the name holds; give it to have a name holding another kind refused."
    • changedInput schema / properties / name / description
      Previous value: -"Required. The website's or skill's name."New value: +"Required. The website's, app's, or skill's name."
    • changedInput schema / properties / org_name / description
      Previous value: -"The Valet organization the website or skill belongs to. Omit to use the organization the account joined first."New value: +"The Valet organization the website, app, or skill belongs to. Omit to use the organization the account joined first."
  11. Changed5 schema fields changed
    • changedInput schema / properties / emails / description
      Previous value: -"Required. The email addresses to share the site with, at most 10 at a time. Sharing again with an address that already has access re-sends the same link rather than creating a second one."New value: +"Required. The email addresses to share it with, at most 10 at a time. Sharing again with an address that already has access re-sends the same link rather than creating a second one."
    • changedInput schema / properties / kind / description
      Previous value: -"The kind you mean. Omit to share whatever the name holds; give it to have a name holding another kind refused. Only a website can be shared by email so far."New value: +"The kind you mean. Omit to share whatever the name holds; give it to have a name holding another kind refused. Only a website or a skill can be shared by email."
    • changedInput schema / properties / kind / enum
      Previous value: -[
      -  "site",
      -  "app"
      -]New value: +[
      +  "site",
      +  "app",
      +  "skill"
      +]
    • changedInput schema / properties / name / description
      Previous value: -"Required. The website's name."New value: +"Required. The website's or skill's name."
    • changedInput schema / properties / org_name / description
      Previous value: -"The Valet organization the site belongs to. Omit to use the organization the account joined first."New value: +"The Valet organization the website or skill belongs to. Omit to use the organization the account joined first."
  12. Added

TDQS

A4.4/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Far beyond the annotations, it discloses that the recipient needs no Valet account and that forwarding the email forwards access, that an app recipient can exercise everything the app does including data changes (explaining destructiveHint=true), that shares are recorded even when mail delivery fails, and how re-sharing to an existing address resolves. This is exactly the extra context annotations cannot carry.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The purpose and the safety-critical caveats (forwarding, app data mutation, no Valet account needed) are front-loaded. Some sentences are long and pack multiple ideas, and the opening clause restates the title, but nearly every sentence carries information an agent would otherwise have to guess.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a seven-parameter, open-world, destructive share operation, the description covers prerequisites, recipient impact, delivery-failure semantics, and idempotency behavior, and the return shape is already carried by the output schema. Nothing an agent needs to call it safely is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already defines kind, name, emails, message, org_name, access_ttl, and expires_in. The description adds nothing parameter-specific beyond noting the link works 'whatever the service's access mode'; it does not clarify the access_ttl/expires_in composition or the kind safeguard. Baseline 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description leads with a specific verb and resource set ('Share a website, app, agent, or skill by email') and immediately explains the mechanism: each address is mailed a link. An agent can distinguish this from unshare_service or the publish_* siblings without opening any schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It gives real preconditions an agent needs before calling: a Valet account must be connected, an agent can only be shared when agent outside access is on, and the behavior when an address already has access. It does not name an alternative tool (e.g. unshare_service for revocation), so it stops short of explicit when-not guidance.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources