Contents
Documentation Job status
job-status
Free Read-only
Check the progress and the result of a job started by another tool.
When to use it. Call it with the job_id a long-running tool returned, every 1 to 2 seconds, until status is succeeded or failed. On succeeded, read result. On failed, read error: the credits of the original call were given back.
Ask your assistant
Once the server is connected, a request in plain words is enough. For example:
Use Mairies de France to check the progress and the result of a job started by another tool, with job_id = "3f2b8c1e-4d5a-4f6b-8a7c-9d0e1f2a3b4c".
Examples
Most clients only need the server address and a sign-in: see Connect. Clients configured by a file take the first block. Your assistant then writes the second one by itself.
{
"mcpServers": {
"mairies-de-france": {
"url": "https://mairies.vosfichiers.com/mcp"
}
}
}
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "job-status",
"arguments": {
"job_id": "3f2b8c1e-4d5a-4f6b-8a7c-9d0e1f2a3b4c"
}
}
}
Put an API key in the API_KEY environment variable first. Create a key
curl -X POST https://mairies.vosfichiers.com/api/v1/job-status \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"job_id": "3f2b8c1e-4d5a-4f6b-8a7c-9d0e1f2a3b4c"
}'
Put an API key in the API_KEY environment variable first. Create a key
import json
import os
import urllib.request
payload = {
"job_id": "3f2b8c1e-4d5a-4f6b-8a7c-9d0e1f2a3b4c",
}
request = urllib.request.Request(
"https://mairies.vosfichiers.com/api/v1/job-status",
data=json.dumps(payload).encode(),
headers={
"Authorization": "Bearer " + os.environ["API_KEY"],
"Content-Type": "application/json",
},
method="POST",
)
with urllib.request.urlopen(request) as response:
print(json.load(response))
Put an API key in the API_KEY environment variable first. Create a key
const response = await fetch("https://mairies.vosfichiers.com/api/v1/job-status", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"job_id": "3f2b8c1e-4d5a-4f6b-8a7c-9d0e1f2a3b4c"
}),
});
console.log(await response.json());
Input
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
| job_id | string | required | none | The job_id returned by the tool. 1 to 64 characters |
Output
| Field | Type | Always present | Description |
|---|---|---|---|
| job_id | string | yes | |
| tool | string | yes | The tool that started the job. |
| status | enum | yes | one of "queued", "running", "succeeded", "failed" |
| progress | integer | yes | From 0 to 100. |
| message | string | yes | What the job is doing now. |
| result | object | yes | The output, once succeeded. |
| error | string | yes | Why it failed, once failed. |
| created_at | string | yes | |
| finished_at | string | yes |
Try it
Run this tool from your account, with a form built from the fields above. A run is a real call; this tool is free.
Open in the playground