Skip to main content
Glama

Read the published source of a website, app, agent, or skill

get_source
Read-onlyIdempotent

Read what is published: the files of a website, app, agent, or skill's active release. Without path it lists them; with path it returns one file's text. Pass release, a version from list_releases, to read an earlier release instead; rollback_service restores a website, app, or agent to it; publish a skill's files again to roll it back. Read before you change something someone else built, so your publish carries their work forward rather than replacing it with yours. Binary files are listed and not returned. Pass git: true instead, when you can run git with network access, to get a read-only Git URL for the release's commit with the commands to clone it. Prefer it to reading files one at a time. git needs key_sha256, the SHA-256 of a new Git key on your machine for this clone, made as create_push describes; the URL carries no credential, works for an hour, and cannot push. git cannot be combined with path. 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>"
    },
    "name": "get_source"
  }
}

Input Schema

NameRequiredDescriptionDefault
gitNoReturn a read-only Git URL for the release's commit and the commands to clone it, instead of file contents. Prefer it when you can run git with network access. Requires key_sha256. The URL carries no credential and works for an hour. Not allowed with path.
nameYesThe website's, app's, agent's, or skill's name, as list_services shows it: the one to read.
pathNoA file to read. Omit to list the files.
releaseNoA release version from list_releases. Omit to read the active release.
org_nameNoThe Valet organization it belongs to. Omit to use the organization the account joined first.
key_sha256NoWith git: names the Git key the clone accepts, as the SHA-256 of a new key you generated on your machine for this clone, made as create_push describes. The key itself is never sent.

Output Schema

NameRequiredDescriptionDefault
orgYesName of the Valet organization the call acted in.
urlNoWith git: a read-only Git clone URL for the release. It carries no credential: the clone proves possession of your key.
nameYesName of the website, app, agent, or skill.
pathNoThe path of the file read, normalized. Set only when you gave path.
filesNoThe release's files with their sizes. Set when you gave no path and no git; absent otherwise.
commitNoWith git: the release's commit, which the commands check out.
contentNoThe file's text. Set only when you gave path; absent for an empty file.
releaseYesVersion of the release the answer was read at: the one you asked for, or the active release.
commandsNoWith git: shell commands to run in order. They clone the repository with your key, then check out commit.
truncatedNoTrue when the listing stopped at 500 files and more exist. Absent otherwise.
expires_atNoWith git: when the URL stops working, as an RFC 3339 time.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • changedInput schema / properties / key_sha256 / description
      Previous value: -"With git: the SHA-256 of a new Git key you generated on your machine for this clone, made as create_push describes. The clone accepts only that key. The key itself is never sent."New value: +"With git: names the Git key the clone accepts, as the SHA-256 of a new key you generated on your machine for this clone, made as create_push describes. The key itself is never sent."
    • 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 read."
  2. Changed1 schema field changed
    • changedInput schema / properties / key_sha256 / description
      Previous value: -"With git: the SHA-256 of a Git key you generated on your machine. The clone accepts only that key. The key itself is never sent."New value: +"With git: the SHA-256 of a new Git key you generated on your machine for this clone, made as create_push describes. The clone accepts only that key. The key itself is never sent."
  3. Changed17 schema fields changed
    • changedInput schema / properties / key_sha256 / description
      Previous value: -"With git: the lowercase hex SHA-256 (64 characters) of a Git key you generated on your machine. Never send the key itself."New value: +"With git: the SHA-256 of a Git key you generated on your machine. The clone accepts only that key. The key itself is never sent."
    • addedInput schema / properties / key_sha256 / pattern
      Added value: +"^[0-9a-f]{64}$"
    • changedInput schema / properties / name / description
      Previous value: -"Required. The service's name."New value: +"The website's, app's, agent's, or skill's name."
    • addedOutput schema / properties / commands / description
      Added value: +"With git: shell commands to run in order. They clone the repository with your key, then check out commit."
    • addedOutput schema / properties / commit / description
      Added value: +"With git: the release's commit, which the commands check out."
    • addedOutput schema / properties / content / description
      Added value: +"The file's text. Set only when you gave path; absent for an empty file."
    • addedOutput schema / properties / expires_at / description
      Added value: +"With git: when the URL stops working, as an RFC 3339 time."
    • addedOutput schema / properties / files / description
      Added value: +"The release's files with their sizes. Set when you gave no path and no git; absent otherwise."
    • addedOutput schema / properties / files / items / properties / binary / description
      Added value: +"True for a file that is not text: invalid UTF-8 or holding a NUL byte. It is listed and not returned."
    • addedOutput schema / properties / files / items / properties / path / description
      Added value: +"Path of the file within the published source. Pass it as path to read a text file."
    • addedOutput schema / properties / files / items / properties / size / description
      Added value: +"Size of the file in bytes."
    • addedOutput schema / properties / name / description
      Added value: +"Name of the website, app, agent, or skill."
    • addedOutput schema / properties / org / description
      Added value: +"Name of the Valet organization the call acted in."
    • addedOutput schema / properties / path / description
      Added value: +"The path of the file read, normalized. Set only when you gave path."
    • addedOutput schema / properties / release / description
      Added value: +"Version of the release the answer was read at: the one you asked for, or the active release."
    • addedOutput schema / properties / truncated / description
      Added value: +"True when the listing stopped at 500 files and more exist. Absent otherwise."
    • addedOutput schema / properties / url / description
      Added value: +"With git: a read-only Git clone URL for the release. It carries no credential: the clone proves possession of your key."
  4. Changed2 schema fields changed
    • changedInput schema / properties / git / description
      Previous value: -"Return a read-only Git URL for the release's commit and the commands to clone it, instead of file contents. Prefer it when you can run git with network access. The URL expires in an hour. Not allowed with path."New value: +"Return a read-only Git URL for the release's commit and the commands to clone it, instead of file contents. Prefer it when you can run git with network access. Requires key_sha256. The URL carries no credential and works for an hour. Not allowed with path."
    • addedInput schema / properties / key_sha256
      Added value: +{
      +  "description": "With git: the lowercase hex SHA-256 (64 characters) of a Git key you generated on your machine. Never send the key itself.",
      +  "type": "string"
      +}
  5. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "additionalProperties": false,
      +  "properties": {
      +    "commands": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": [
      +        "null",
      +        "array"
      +      ]
      +    },
      +    "commit": {
      +      "type": "string"
      +    },
      +    "content": {
      +      "type": "string"
      +    },
      +    "expires_at": {
      +      "type": "string"
      +    },
      +    "files": {
      +      "items": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "binary": {
      +            "type": "boolean"
      +          },
      +          "path": {
      +            "type": "string"
      +          },
      +          "size": {
      +            "type": "integer"
      +          }
      +        },
      +        "required": [
      +          "path",
      +          "size",
      +          "binary"
      +        ],
      +        "type": "object"
      +      },
      +      "type": [
      +        "null",
      +        "array"
      +      ]
      +    },
      +    "name": {
      +      "type": "string"
      +    },
      +    "org": {
      +      "type": "string"
      +    },
      +    "path": {
      +      "type": "string"
      +    },
      +    "release": {
      +      "maximum": 2147483647,
      +      "minimum": -2147483648,
      +      "type": "integer"
      +    },
      +    "truncated": {
      +      "type": "boolean"
      +    },
      +    "url": {
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "org",
      +    "name",
      +    "release"
      +  ],
      +  "type": "object"
      +}
  6. Changed1 schema field changed
    • addedInput schema / properties / git
      Added value: +{
      +  "description": "Return a read-only Git URL for the release's commit and the commands to clone it, instead of file contents. Prefer it when you can run git with network access. The URL expires in an hour. Not allowed with path.",
      +  "type": "boolean"
      +}
  7. Changed1 schema field changed
    • addedInput schema / properties / release
      Added value: +{
      +  "description": "A release version from list_releases. Omit to read the active release.",
      +  "minimum": 1,
      +  "type": "integer"
      +}
  8. Added

TDQS

A4.6/5.0
Behavior4/5

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

Annotations already declare readOnlyHint=true and destructiveHint=false, but the description adds substantial behavior: binary files are listed and not returned, release defaults to active, the git URL carries no credential, expires after an hour, cannot push, requires key_sha256, and cannot be combined with path. The account-connection prerequisite is also disclosed. Only minor gap is nothing about listing pagination or file-count limits.

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?

Front-loaded with the core action and the list/read distinction, then alternatives, then the git path. Dense but nearly every sentence carries a constraint; the main cost is that release/rollback mechanics and git caveats are packed into long clauses that take attentive reading.

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?

With an output schema present, return-value detail is unnecessary, and the description covers everything else an agent needs: auth prerequisite, binary handling, default release, and the full git alternative with its credential and expiry constraints.

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

Parameters4/5

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

Schema coverage is 100%, so the baseline is 3, but the description adds cross-parameter semantics the schema only partially conveys: release must come from list_releases, git requires key_sha256 and is mutually exclusive with path, and omitting path yields a listing. That is real added meaning beyond per-field descriptions.

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?

States a specific verb and resource: 'Read what is published: the files of a website, app, agent, or skill's active release,' then immediately clarifies the two modes (list vs. single file). This is clearly distinct from siblings like get_service, get_skill, and list_releases.

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

Usage Guidelines5/5

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

Gives explicit when-to-use guidance ('Read before you change something someone else built, so your publish carries their work forward') and names alternatives with their conditions: list_releases for versions, rollback_service for websites/apps/agents, re-publish for skills, and git:true over file-by-file reads when git with network access is available.

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