Request Spec
request_specLogs a request for a spec that doesn't exist yet and notifies maintainers. Call this when a user asks for a provider or capability that has no spec in the registry (check list_providers first), or needs a capability in a country where no listed provider offers it (search_specs with country first). This helps maintainers prioritize which specs and providers to add next.
Args:
capability (string): Capability name e.g. "create_payment", or what is needed e.g. "ussd"
provider (string?): Provider slug e.g. "wave" — omit when no provider is named
country_code (string?): ISO 3166-1 alpha-2 code e.g. "SN" — required when provider is omitted
follow_up ("none" | "github_issue", default "none"): "none" records the request only; "github_issue" also returns issue_url, a pre-filled GitHub issue the user can review and submit
Returns: { logged: true, count, issue_url? } if the request was recorded — count is the all-time number of times this provider + capability (or, without a provider, capability + country) was requested, including this one (a repeated request counts again). count is absent if it could not be determined: do not guess a number. issue_url only with follow_up "github_issue": give it to the user, who submits it. { logged: false, reason: "spec already exists" }: the spec is in the registry — use the existing spec (get_spec) instead. isError if the request could not be stored: tell the user it was NOT recorded.
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": {
"capability": "<capability>"
},
"name": "request_spec"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| provider | No | Provider slug e.g. "wave" | |
| follow_up | No | "github_issue" also returns issue_url, a pre-filled GitHub issue the user can submit | none |
| capability | Yes | Capability name e.g. "create_payment", or what is needed e.g. "ussd" | |
| country_code | No | ISO 3166-1 alpha-2 country code e.g. "SN" — required without provider |