Create a public link to a result
create_result_share_linkCreates a public web link to one of your results, so you can hand the numbers to someone who has no Neumann account. Use this when the user wants to send, publish or show a result to another person; to put the numbers in the conversation instead, call get_simulation_results. It works for any run you own: a run from run_monte_carlo_simulation, rank_inputs_by_impact or summarize_outcome_scenarios, and a run of a graph you saved. There is one share tool for every kind of run -- do not look for a separate one. Pass the run_id the run tool returned when the run was made, earlier in the conversation; no tool lists runs, and you do not need a graph_id. That holds for a run of a saved model too: when the user asks to share the run of a saved graph, call this tool directly with that run's run_id -- list_graphs and get_graph return graph_ids, not run_ids, so they are not a step here. Calling it again for the same run returns the same link rather than a second one. Anyone who has the link can open the result without signing in, so ask the user before you create one. delete_run deletes the stored result, which also stops its share link working. There is no way to turn off a link and keep the result. A run made without an account takes two calls, and the run_id is what carries it from one to the other. First call: the caller has no account, so call this tool with the run_id anyway; nothing is shared, and it returns a message asking the user to sign in with a free Kromatic account -- tell the user that. Second call: once the user has signed in, call this tool again with the SAME run_id. Only that second call shares the run and keeps it on the account; signing in alone shares nothing, and a different run_id, or a new run, does not carry the claim. Do it within 24 hours, because a run made without an account is deleted after that. When you tell the user what happens next, say both steps: sign in, then you will share it using the same run. It returns the share_url. It needs a Neumann account: send your key, or your signed-in token, in the Authorization header as a Bearer credential. No Neumann tool takes an api_key argument. Cost: free -- it debits no credits and spends none of your free daily runs -- but it needs an account; an anonymous caller gets authentication_required.
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": {
"run_id": "<run_id>"
},
"name": "create_result_share_link"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| run_id | Yes | The run to share, as returned by any run tool. For a run made without an account, sign in and then call again with this same run_id: signing in alone shares nothing. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| billing | No | Who you are and what this call cost: principal, auth source, credits debited and balance, or the anonymous allowance left today. | |
| share_url | Yes | A web address anyone can open to see this result, with no Neumann account and no credential. Asking again for the same run returns this same link. |