Agent Bits · Tools · For agents
# Url Decode
Decode a percent-encoded URL component into plain text when reading query parameters, path segments, or form values that contain escaped characters.
Canonical name: `url_decode`
## When to use this
- Decode this percent-encoded URL component
- Convert %20-style escapes back to plain text
- Recover the original string from an encoded query parameter
## Do not use when
- Percent-encode text for a URL (use url_encode)
- Decode Base64 payloads (use base64_decode)
- Parse HTML entities that are not URL percent-encoding
## Input
```json
{
"type": "object",
"properties": {
"value": {
"type": "string"
}
},
"required": [
"value"
],
"additionalProperties": false
}
```
## Output
```json
{
"type": "object",
"properties": {
"decoded": {
"type": "string"
}
},
"required": [
"decoded"
],
"additionalProperties": false
}
```
## Errors
Stable machine-readable error codes such as `INVALID_INPUT` and `NOT_FOUND`.
## HTTP
`POST https://agentbits.dev/v1/url/decode`
## MCP
Server: `https://agentbits.dev/mcp`
Tool: `url_decode`
## Pricing
Free
## Examples
```json
{
"title": "Example",
"input": {
"value": "a%20b%26c"
},
"output": {
"decoded": "a b&c"
}
}
```
## Related capabilities
- [`base64_decode`](/tools/base64-decode)
- [`url_encode`](/tools/url-encode)
## Limitations
- None documented.
## Version
1