Contents
Documentation Account status
account-status
Free Read-only
Show the caller's plan, remaining credits and renewal date.
When to use it. Call it when the user asks how many credits are left, or after an insufficient_credits error. It is free.
Ask your assistant
Once the server is connected, a request in plain words is enough. For example:
Use Mairies de France to show the caller's plan, remaining credits and renewal date.
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": "account-status",
"arguments": {}
}
}
Put an API key in the API_KEY environment variable first. Create a key
curl -X POST https://mairies.vosfichiers.com/api/v1/account-status \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{}'
Put an API key in the API_KEY environment variable first. Create a key
import json
import os
import urllib.request
payload = {}
request = urllib.request.Request(
"https://mairies.vosfichiers.com/api/v1/account-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/account-status", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({}),
});
console.log(await response.json());
Input
This tool takes no argument: send an empty object.
Output
| Field | Type | Always present | Description |
|---|---|---|---|
| plan | string | yes | Name of the current plan. |
| allowance_remaining | integer | yes | Credits left in this period's allowance. |
| purchased_credits | integer | yes | Purchased credits; they never expire. |
| credits_available | integer | yes | Total credits that can be spent now. |
| monthly_credits | integer | yes | Allowance granted by the plan each period. |
| renews_at | string | yes | When the allowance is reset (ISO 8601, UTC). |
| billing_url | string | yes | Where to add credits or change plan. |
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