← The evidence ledger
Evidence row 3001054
Observed , by probe.mcp/1.
- Kind
- mcp.tools
- About
- endpoint ad912a01-10a4-4176-bb5e-6b25a89c4975
- Recorded
- Previous row
- None: the first of its kind about this subject
- Body SHA-256
- 9070d9d7cf759df6cf029ceb56769b50436a7fe077d84f75c94c54254df9175f
- Leaf
- 0xedbb2bc3005eb9ec3374070e83ff62eadde0d47b196630624869f2c4acd9387f
What was observed
{
"count": 20,
"tools": [
{
"description": "Send a POST, PUT, PATCH or DELETE request to any viaSocket API endpoint for the user and return its response: every write (create, update, publish, delete). For GET requests use call_any_read_api_of_viasocket. Look the endpoint up with get_viasocket_api_docs first to get its URL, headers, query params and body, unless the skill or a dedicated tool on this server already gives them exactly. Load the quickstart-viasocket-developer-hub skill first: it explains which tool to use when. Pass the full url with path variables filled in, the headers the docs list, query params in `query` (not in the url) and the JSON body in `body`. For the auth header the docs name (Authorization, proxy_auth_token, x-api-key, ...), pass it with an empty value \"\": the signed-in user's token is filled in automatically. Never put a real or made-up token there; if the docs name no auth header, leave it out and the token is sent as Authorization. If the API needs the user to sign in, they're asked the first time. Only for the viaSocket endpoints documented on this server: it attaches the viaSocket sign-in, so never use it for Embarko (ship.embarko.ai) or any other service. Returns { status, ok, headers, data }: the HTTP status and the response body, including error details on failure.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"body": {
"additionalProperties": {},
"description": "JSON request body, as the endpoint's docs show it. Leave it out when the endpoint takes no body.",
"propertyNames": {
"type": "string"
},
"type": "object"
},
"headers": {
"additionalProperties": {},
"description": "Request headers as name/value pairs, as the docs list them. Give the auth header (Authorization, proxy_auth_token, x-api-key, ...) an empty value \"\" so the signed-in user's token is filled in; never put a token here yourself. Pass {} when the endpoint needs no headers. Example: {\"proxy_auth_token\": \"\", \"Content-Type\": \"application/json\"}",
"propertyNames": {
"type": "string"
},
"type": "object"
},
"method": {
"description": "HTTP method from the endpoint's docs",
"enum": [
"POST",
"PUT",
"PATCH",
"DELETE"
],
"type": "string"
},
"query": {
"additionalProperties": {},
"description": "Query params as name/value pairs; an array sends the param once per item. Example: {\"type\": \"flow\", \"bringflows\": true}",
"propertyNames": {
"type": "string"
},
"type": "object"
},
"url": {
"description": "Full endpoint URL with path variables replaced by real values, e.g. https://api.example.com/users/42. Put query params in `query`, not here.",
"type": "string"
}
},
"required": [
"url",
"headers",
"method"
],
"type": "object"
},
"name": "call_any_api_of_viasocket"
},
{
"description": "Read from any viaSocket API endpoint with a GET request for the user and return its response. Use it once you know the exact endpoint: look it up with get_viasocket_api_docs first to get its URL, headers, query params and body, unless the skill or a dedicated tool on this server already gives them exactly. Load the quickstart-viasocket skill first: it explains which tool to use when. For POST, PUT, PATCH and DELETE use call_any_api_of_viasocket. Pass the full url with path variables filled in, the headers the docs list, and query params in `query` (not in the url). For the auth header the docs name (Authorization, proxy_auth_token, x-api-key, ...), pass it with an empty value \"\": the signed-in user's token is filled in automatically. Never put a real or made-up token there; if the docs name no auth header, leave it out and the token is sent as Authorization. If the API needs the user to sign in, they're asked the first time. Returns { status, ok, headers, data }: the HTTP status and the response body, including error details on failure.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"headers": {
"additionalProperties": {},
"description": "Request headers as name/value pairs, as the docs list them. Give the auth header (Authorization, proxy_auth_token, x-api-key, ...) an empty value \"\" so the signed-in user's token is filled in; never put a token here yourself. Pass {} when the endpoint needs no headers. Example: {\"proxy_auth_token\": \"\", \"Content-Type\": \"application/json\"}",
"propertyNames": {
"type": "string"
},
"type": "object"
},
"query": {
"additionalProperties": {},
"description": "Query params as name/value pairs; an array sends the param once per item. Example: {\"type\": \"flow\", \"bringflows\": true}",
"propertyNames": {
"type": "string"
},
"type": "object"
},
"url": {
"description": "Full endpoint URL with path variables replaced by real values, e.g. https://api.example.com/users/42. Put query params in `query`, not here.",
"type": "string"
}
},
"required": [
"url",
"headers"
],
"type": "object"
},
"name": "call_any_read_api_of_viasocket"
},
{
"description": "Make a sign-in link so the user connects an app account (Google, Slack, an API key…) to viaSocket. Body { \"service_ids\": [\"<service_id>\"] } answers data[] with a connection_url per app. Give the user the link, wait until they say they signed in, then call list_connections again to get the auth_id. It only makes the link; nothing is connected until the user signs in.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"service_ids": {
"description": "e.g. [\"rowbu58rc\"]",
"items": {},
"type": "array"
}
},
"type": "object"
},
"name": "create_connection_link"
},
{
"description": "Get the viaSocket organization (id and details) that the signed-in user's token belongs to. Read-only, no inputs. Call this first whenever you need the organization id (orgId) for other viaSocket Developer Hub calls such as List Plugins, Get Plugin or analytics, instead of asking the user for it.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"type": "object"
},
"name": "get_org_details_by_token"
},
{
"description": "Get run counts, error counts and flow counts for every action and trigger version of a plugin (filter=getPluginDetails, identifier=<pluginId>, optional startTime and endTime dates).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"endTime": {
"description": "Optional end date. e.g. 2026-10-19",
"type": "string"
},
"filter": {
"description": "Required (access check). Use getPluginDetails. e.g. getPluginDetails",
"type": "string"
},
"identifier": {
"description": "Required. Plugin id",
"type": "string"
},
"orgId": {
"description": "Your viaSocket organization id",
"type": "string"
},
"startTime": {
"description": "Optional start date. e.g. 2026-10-01",
"type": "string"
}
},
"required": [
"orgId"
],
"type": "object"
},
"name": "get_plugin_analytics"
},
{
"description": "Browse the viaSocket API docs, one level at a time. Call it without arguments to get the top level: the modules and pages with a short description and the endpoints they hold. Call it with `path` set to a module's or page's link (or path) to get what is inside it; each listing links the next level. Call it with `path` set to an endpoint's link ending in \".openapi.yml\" to get that endpoint as an OpenAPI file: method, url, headers, query params, path variables, a request body example and sample responses. Fetch only the level you need.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"path": {
"description": "A link from a listing, exactly as given (e.g. \"https://docs.example.com/sms/llms.txt\" or \".../sms/send-sms.openapi.yml\"), or just the path (\"sms\", \"sms/send-sms.openapi.yml\"). Leave it out for the top level.",
"type": "string"
}
},
"type": "object"
},
"name": "get_viasocket_api_docs"
},
{
"description": "Gets the viaSocket organization's embed signing secret (VIASOCKET_EMBED_SECRET) into the developer's .env encrypted, so you never see it. Use it in SDK setup. Get orgId with get_org_details_by_token first. Before calling, run `docstar-cli key request` in the project folder and pass its publicKey; then run the `save` command this tool returns, then its `emit` command (the developer can choose another .env file). Never ask for, print or repeat the secret.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"orgId": {
"description": "The orgId the key is created for",
"type": "string"
},
"publicKey": {
"description": "The publicKey printed by `docstar-cli key request`, exactly as printed",
"type": "string"
}
},
"required": [
"publicKey",
"orgId"
],
"type": "object"
},
"name": "get_viasocket_embed_secret"
},
{
"description": "List all versions of an action or trigger (filter=getActionVersions, identifier=<actionId>), with code, inputs, authid, status and verification status. Use fields to keep the response small.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"fields": {
"description": "Optional comma-separated columns, e.g. rowid,versionid,status,verificationstatus",
"type": "string"
},
"filter": {
"description": "Required. Must be getActionVersions. e.g. getActionVersions",
"type": "string"
},
"identifier": {
"description": "Required. Action id",
"type": "string"
},
"orgId": {
"description": "Your viaSocket organization id",
"type": "string"
}
},
"required": [
"orgId"
],
"type": "object"
},
"name": "list_action_versions"
},
{
"description": "List a plugin's actions and triggers (filter=getAllActions, identifier=<pluginId>), or get one (filter=getActionDetails, identifier=<actionId>). Use it to find an actionId.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"fields": {
"description": "Optional comma-separated columns, e.g. rowid,name,type,status",
"type": "string"
},
"filter": {
"description": "Required. getAllActions (by plugin) or getActionDetails (one action by rowid). e.g. getAllActions",
"type": "string"
},
"identifier": {
"description": "Required. Plugin id for getAllActions; action id for getActionDetails",
"type": "string"
},
"orgId": {
"description": "Your viaSocket organization id",
"type": "string"
}
},
"required": [
"orgId"
],
"type": "object"
},
"name": "list_actions_and_triggers"
},
{
"description": "List what an app can do for the user. Body { \"serviceId\": \"<service_id from search_apps>\" } (camelCase) answers actions[] with action_id, action_name, action_description and fields_for_action_details. Use it to pick the action that matches the request (Gmail \"Send Email\", Google Sheets \"Add Row\", HubSpot \"Create Contact\") before connecting or running anything. Public catalog, no sign-in needed.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"serviceId": {
"description": "e.g. rowbu58rc",
"type": "string"
}
},
"type": "object"
},
"name": "list_app_actions"
},
{
"description": "List a plugin's authentication versions (filter=getAuthDetails, identifier=<pluginId>) to find an authid. Responses include decrypted client secrets: never show them to the user.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"fields": {
"description": "Optional comma-separated columns",
"type": "string"
},
"filter": {
"description": "Required. getAuthDetails (all of a plugin's auth versions) or updateAuthDetails (one auth version by rowid). e.g. getAuthDetails",
"type": "string"
},
"identifier": {
"description": "Required. Plugin id for getAuthDetails; auth version rowid for updateAuthDetails",
"type": "string"
},
"orgId": {
"description": "Your viaSocket organization id",
"type": "string"
}
},
"required": [
"orgId"
],
"type": "object"
},
"name": "list_auth_versions"
},
{
"description": "The app accounts the signed-in user has already connected to viaSocket. Body {} answers rows with auth_id, service_id, service_name and connection_label (a JSON string: parse it before showing it, e.g. the email of the Gmail account). Match service_id to find the auth_id an action or automation needs; if the user has several accounts of one app, ask which. If the app is not there, use create_connection_link.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"type": "object"
},
"name": "list_connections"
},
{
"description": "List an organization's embed projects (type=embed) for viaSocket SDK setup. Each data.projects[].id is a project_id (VIASOCKET_PROJECT_ID). Reuse an existing embed: one embed serves a whole product. Only if there is none, create one with the Create Embed Project endpoint (via call_any_api) after the developer confirms.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"bringflows": {
"description": "Optional. true also returns the flows of each project. e.g. false",
"type": "string"
},
"orgId": {
"description": "Organization id from Find Organizations or Get Org Details By Token",
"type": "string"
},
"type": {
"description": "Required. `embed` for SDK projects (`flow` and `default` are the workspace's own automation projects). e.g. embed",
"type": "string"
}
},
"required": [
"orgId"
],
"type": "object"
},
"name": "list_embed_projects"
},
{
"description": "List every viaSocket Developer Hub plugin (app) the user's organization owns. Send filter=getAllPlugins and identifier equal to the orgId in the path. Start here to find a pluginId (rowid).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"fields": {
"description": "Optional comma-separated list of columns to return, e.g. rowid,name,status,iconurl",
"type": "string"
},
"filter": {
"description": "Required. Must be getAllPlugins. e.g. getAllPlugins",
"type": "string"
},
"identifier": {
"description": "Required. Your orgId (same as the path)",
"type": "string"
},
"orgId": {
"description": "Your viaSocket organization id",
"type": "string"
}
},
"required": [
"orgId"
],
"type": "object"
},
"name": "list_plugins"
},
{
"description": "Quickstart for viaSocket: use the user's own apps from their AI (send an email, post to Slack, add a sheet row, read a CRM; any of 2,300+ apps), build automations (flows) across those apps, and for developers: build and manage viaSocket plugins in the Developer Hub, set up a product's viaSocket keys, give a product its own MCP server. Routes plug work through the plug skills index, product integration through the viaSocket skill, and Embarko deploy through Embarko's quickstart. Load this before any viaSocket task. Call this to load the full instructions for this skill before doing the task.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"type": "object"
},
"name": "quickstart-viasocket-developer-hub"
},
{
"description": "Report a problem to viaSocket while building with it: an error, a confusion, wrong docs or skills, a user correction, or a missing capability. Problems only, never success; no need to ask the user; a failed report never stops the task. Plugs: fix or extend the user's own plugs (the ones in list_plugins) yourself, and build a plug for an app that has none. A plug used in flows but not in list_plugins is viaSocket's: never edit it, report it here (refs.pluginId, refs.actionId; a missing action, trigger or field is kind missing_capability, with exactly what is needed and why). Body: source (sdk | http_api | plug | action | trigger | connection | skill | other), kind (error | confusion | missing_capability | wrong_instructions | user_correction) and feedback (what happened, in plain words), plus optional severity, stage, intent, attempted, expected, actual, error, refs, env and retries. Never include secrets, tokens or script_id. The org and user come from the sign-in.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"actual": {
"description": "e.g. 500 INTERNAL",
"type": "string"
},
"attempted": {
"description": "e.g. Ran Send Message with channel and text from the document's sample",
"type": "string"
},
"env": {
"additionalProperties": {},
"description": "e.g. {\"sdkVersion\":\"0.7.0\",\"framework\":\"nextjs\",\"language\":\"typescript\",\"client\":\"claude-code\"}",
"propertyNames": {
"type": "string"
},
"type": "object"
},
"error": {
"additionalProperties": {},
"description": "e.g. {\"status\":500,\"code\":\"INTERNAL\",\"message\":\"failed\"}",
"propertyNames": {
"type": "string"
},
"type": "object"
},
"expected": {
"description": "e.g. Message posted",
"type": "string"
},
"feedback": {
"description": "e.g. Slack Send Message returns 500 on valid input; same call worked yesterday",
"type": "string"
},
"intent": {
"description": "e.g. Post to a Slack channel when an order is created",
"type": "string"
},
"kind": {
"description": "e.g. error",
"type": "string"
},
"refs": {
"additionalProperties": {},
"description": "e.g. {\"app\":\"slack\",\"pluginId\":\"rowslack123\",\"actionId\":\"rowsendmsg01\",\"requestId\":\"req_abc\"}",
"propertyNames": {
"type": "string"
},
"type": "object"
},
"retries": {
"description": "e.g. 2",
"type": "number"
},
"severity": {
"description": "e.g. degraded",
"type": "string"
},
"source": {
"description": "e.g. action",
"type": "string"
},
"stage": {
"description": "e.g. actions_and_events",
"type": "string"
}
},
"type": "object"
},
"name": "report_feedback"
},
{
"description": "Call once right after you publish something on the user's own plug (one in list_plugins): a new plug, or a new action, trigger, version or connection on it. viaSocket then reviews the published plug and may add missing actions or triggers. Body: pluginId (the plug rowid, required), published (new_plug | new_action | new_trigger | new_version | connection), plus optional app (the app's name), actionIds (rowids of the actions or triggers just published) and note (plain words, never secrets). No need to ask the user; a failed call never stops the task. The org and user come from the sign-in. Not for problems: use report_feedback for those.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"actionIds": {
"description": "e.g. [\"rowaction1234\",\"rowtrigger567\"]",
"items": {},
"type": "array"
},
"app": {
"description": "e.g. Tally",
"type": "string"
},
"note": {
"description": "e.g. Published privately with 4 actions and 1 trigger; OAuth 2.0 connection",
"type": "string"
},
"pluginId": {
"description": "e.g. rowtally12345",
"type": "string"
},
"published": {
"description": "e.g. new_plug",
"type": "string"
}
},
"type": "object"
},
"name": "report_published"
},
{
"description": "Do one thing in the user's app right now, on their own account: send an email, post a message, add a row, create a record, fetch data. Body { service_id, action_id, auth_id, instructions, thread_id }: service_id from search_apps, action_id from list_app_actions, auth_id from list_connections, instructions in plain words carrying every value (recipient, subject, body, sheet name…), thread_id an id you make up and reuse for retries of the same request. viaSocket's builder turns the instructions into the action's input and runs it; the reply is the app's own result. It acts for real, so say exactly what it will do (which account, which action, which values) and get the user's yes first. For something that should happen repeatedly (\"every time\", \"every morning\"), build an automation instead, as the skill describes.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"action_id": {
"description": "e.g. row1jrbor",
"type": "string"
},
"auth_id": {
"description": "e.g. authAbC123xyz",
"type": "string"
},
"instructions": {
"description": "e.g. List the channels in the workspace",
"type": "string"
},
"service_id": {
"description": "e.g. rowbu58rc",
"type": "string"
},
"thread_id": {
"description": "e.g. slack-send-message-sales",
"type": "string"
}
},
"type": "object"
},
"name": "run_app_action"
},
{
"description": "Find an app the user wants to use from their AI: Gmail, Slack, Google Sheets, HubSpot, Notion, Trello or any of 2,300+ apps. Body { \"searchquery\": \"gmail\" } answers services[] with service_id, service_name and service_description. This is the first step whenever the user asks to send, read, create, update or search something in one of their apps, or to automate something across apps. The catalog is public: no sign-in needed for this call.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"searchquery": {
"description": "e.g. slack",
"type": "string"
}
},
"type": "object"
},
"name": "search_apps"
},
{
"description": "Search the viaSocket documentation with a natural-language question. Returns the most relevant passages with their page URLs.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"query": {
"description": "What to look for, e.g. \"how do I send a WhatsApp template message\"",
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "search_viasocket_docs"
}
]
}What the leaf hashes
{"body":"9070d9d7cf759df6cf029ceb56769b50436a7fe077d84f75c94c54254df9175f","id":3001054,"kind":"mcp.tools","method":"probe.mcp/1","observed_us":1793792839233765,"prev":null,"subject":"ad912a01-10a4-4176-bb5e-6b25a89c4975","subject_kind":"endpoint"}Proof
Fold these into the leaf in order, hashing each sorted pair with keccak256, to reach the root of (424109 rows).
- 0xedbb4cbe71f60e528212efc607501d523f94fff1bdfe5373168c8f0dad56eef2
- 0x5f4abb4dc5f3990862ad3a569ccbea1e10cc8371a086e72050b2da2b00e296ca
- 0xa576bae9c006924c5388d8dbd0703312b6054251be442ff25e1330455ba66aeb
- 0x11a6b103352894a50e45664ea9830c9d0ccf47704b3b835a631619a71702d319
- 0x46cda967b5e4164e1c9f32270b9bbee8ae4a8d1650d5169fb5eaf8b4cf7e76e5
- 0xdaf3a6ebaf718a3ee6d34b266a9da4900ffdee1482868ea9454aa7b220ad65f9
- 0xd12a342e4435c6a3c05a345fc379cee5156377c08660a858ed90ef7ef85e465f
- 0x9c3f102743cdd07078ceca51704140e29e016bd9077f63723f2d5fb392c0fc1a
- 0x032b1e2736a55656b7f9f41ace198a1b4afb51773fefee3fb3812cbf697418fd
- 0x473e88a49751226aafe947d6b26c31bbd29f16718760ee6762bf50eb8e964ddf
- 0x78010240049b81295bebd3863d01e868dc3455374f5a3f1839330bfad3f0c1d6
- 0x88511143733033f416ac5f86c210c254de293dcba7fd289f1c9df79aee0dadf4
- 0x956f4913934270080a8ccb34cbd8f0c13aa2c31b748acb745e577aaac06fbf54
- 0xbf7e123029ce4365b819863a1c92b78b356111fa8f0bd187055546ccf59fa8ff
- 0xb0895d3fcf0eaeb1070bfba1f01a9f303d7588c23fce13bfa62350e6db1b923a
- 0x86f9d5fa5ffaf68243f66522b43dd83f29ab34fea48dd0c3366dc8c8821ebd3f
- 0xbb1998892a86d9633ea7b5de06760114b45777da649c217062ff0d65d7095f34
- Day root
- 0xd4eed8c0ea3c90ec6f262b19fcc3b849f30cb82a0f84b8b89569e48af7d0c1ee
- Chained
- 0x59305749c32724a02a23c368834d8a36ae9908da93a915e2962fffe01b4e591b
- Published
- On Arc Testnet, block 70772483: 0x813d56041c1efd407e56047129b597b154a1cb26458bb2768fd0a4630ac97345