Agent Bits MCP server
Commit Aug 26, 2026Provides machine-readable utilities and datasets including data validation, conversions, and lookups for AI agents.
Also known as rwaldman/agentbits, agentbits
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.3.0
- Last commit
- Aug 26, 2026
- License
- MIT
What is Agent Bits MCP?
Agent Bits provides machine-readable utilities and datasets including data validation, conversions, and lookups for AI agents.
Summary generated from the project's README
About Agent Bits MCP server
Agent Bits provides a collection of machine-readable utilities and datasets designed specifically for AI agents. It functions as a hosted service that agents can access via MCP or HTTP interfaces. Developers can integrate this server into clients like Claude Code, Cursor, OpenCode, and Cloudflare Agents by connecting to the remote URL.
The server offers various free tools including country_lookup, currency_lookup, timezone_convert, and unit_convert. It also includes validation capabilities such as isbn_validate, uuid_validate, luhn_validate, and json_validate. For data encoding, it provides base64 and url encoding and decoding functions.
While most individual tools are free, the countries_bulk capability requires payment. This service uses the x402 protocol on Base with USDC, allowing agents to pay programmatically without needing a traditional account, signup, or API key. This architecture enables autonomous machine-to-machine transactions for premium datasets.
What you can do with it
- 1Validate data formatsAn agent can verify if a string is a valid UUID or a properly formatted JSON object.
- 2Convert time and unitsA developer can instruct an agent to change timestamps between different IANA timezones or convert common units.
- 3Retrieve geographic metadataAn agent can look up specific details about a country using its ISO 3166-1 alpha-2 code.
- 4Perform programmatic paymentsAn agent can autonomously purchase the complete countries dataset using USDC on the Base network.
Written from the project's README. Every use case is checked against a quote from it.
How to install Agent Bits MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Agent Bits MCP in Claude Code
$ claude mcp add --transport http agentbits https://agentbits.dev/mcpInstall Agent Bits MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"agentbits": {
"url": "https://agentbits.dev/mcp"
}
}
}Install Agent Bits MCP in VS Code
.vscode/mcp.json
{
"servers": {
"agentbits": {
"type": "http",
"url": "https://agentbits.dev/mcp"
}
}
}Install Agent Bits MCP in VS Code CLI
$ code --add-mcp '{"name":"agentbits","type":"http","url":"https://agentbits.dev/mcp"}'Install Agent Bits MCP in Codex
$ codex mcp add agentbits --url https://agentbits.dev/mcpInstall Agent Bits MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.agentbits] url = "https://agentbits.dev/mcp"
Install Agent Bits MCP in Gemini CLI
$ gemini mcp add -s user --transport http agentbits https://agentbits.dev/mcpInstall Agent Bits MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"agentbits": {
"url": "https://agentbits.dev/mcp",
"type": "http"
}
}
}Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablerwaldman/agentbits is public and reachablegithub.com/rwaldman/agentbits ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-08-26github.com/rwaldman/agentbits ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 277 msPass
README
View on GitHubAgent Bits
Machine-readable utilities and datasets for AI agents.
Website: https://agentbits.dev
MCP: https://agentbits.dev/mcp
Catalog: https://agentbits.dev/catalog.json
OpenAPI: https://agentbits.dev/openapi.json
Official MCP Registry manifest: server.json
Canonical links
| Surface | URL |
|---|---|
| Website | https://agentbits.dev |
| Agent guide | https://agentbits.dev/for-agents |
| MCP | https://agentbits.dev/mcp |
| Catalog | https://agentbits.dev/catalog.json |
| OpenAPI | https://agentbits.dev/openapi.json |
Official server.json |
https://agentbits.dev/server.json |
| Smithery server card | https://agentbits.dev/.well-known/mcp/server-card.json |
| llms.txt | https://agentbits.dev/llms.txt |
| Docs | https://agentbits.dev/docs/ |
| MCP registries | docs/mcp-registries.md |
| Tools | https://agentbits.dev/tools/ |
| Datasets | https://agentbits.dev/datasets/ |
What this repository is
This repository contains public documentation and discovery metadata for Agent Bits.
It exists for:
- discoverability
- documentation
- machine-readable capability descriptions
- public specifications
- public API/MCP documentation
- examples of consuming the hosted service
- public project metadata
- links to the hosted service
It does not contain the Agent Bits implementation.
Capability table
| Capability | Description | Pricing | Interfaces |
|---|---|---|---|
country_lookup |
Look up country metadata by ISO 3166-1 alpha-2 code | Free | HTTP · MCP |
currency_lookup |
Look up currency metadata by ISO 4217 code | Free | HTTP · MCP |
timezone_convert |
Convert timestamps between IANA timezones | Free | HTTP · MCP |
timestamp_convert |
Convert unix/ISO timestamps | Free | HTTP · MCP |
unit_convert |
Convert common units | Free | HTTP · MCP |
isbn_validate |
Validate ISBN-10/ISBN-13 | Free | HTTP · MCP |
uuid_validate |
Validate UUID strings | Free | HTTP · MCP |
luhn_validate |
Validate numbers with the Luhn algorithm | Free | HTTP · MCP |
json_validate |
Validate JSON text | Free | HTTP · MCP |
base64_encode / base64_decode |
Encode/decode Base64 | Free | HTTP · MCP |
url_encode / url_decode |
Encode/decode URL components | Free | HTTP · MCP |
mime_lookup |
Look up MIME type metadata | Free | HTTP · MCP |
language_lookup |
Look up language metadata | Free | HTTP · MCP |
http_status_lookup |
Look up HTTP status code metadata | Free | HTTP · MCP |
tld_lookup |
Look up TLD metadata | Free | HTTP · MCP |
countries_bulk |
Retrieve the complete countries dataset | Paid (x402 USDC on Base) | HTTP · MCP · x402 |
See catalog.json for schemas, use_when / do_not_use_when, and payment metadata.
Connect MCP in under a minute
{
"mcpServers": {
"agentbits": {
"url": "https://agentbits.dev/mcp"
}
}
}
Works with Claude Code, Cursor, OpenCode, Cloudflare Agents, and generic MCP clients.
Details: docs/mcp.md · for-agents.md · docs/mcp-registries.md
MCP registries
Packaging for Smithery, Glama, the official MCP Registry, PulseMCP, MCP.so, and related directories is documented in docs/mcp-registries.md.
Suggested GitHub topics: ai-agents, mcp, mcp-server, agent-tools, ai-tools, x402, agentic-ai, cloudflare-workers, machine-payments
How agents discover Agent Bits
- Read
for-agents.mdor https://agentbits.dev/for-agents - Fetch
catalog.json - Select a capability using description +
use_when/do_not_use_when - Open the capability page under
tools/ - Invoke MCP or HTTP
Payments
Paid capabilities use x402 on Base with USDC.
No account. No API key. No signup. Agents can pay programmatically.
Unpaid paid requests return HTTP 402 with machine-readable payment instructions.
See docs/payments.md.
Status
Initial MVP capabilities are published in the catalog.
Glama listing
- Server: https://glama.ai/mcp/servers/rwaldman/agentbits
- Connector: https://glama.ai/mcp/connectors/dev.agentbits/agent-bits
- Score tab: https://glama.ai/mcp/servers/rwaldman/agentbits/score
Score badge may show “Not found” until a Glama release exists (see docs/mcp-registries.md).
License
MIT — see LICENSE.
This repository contains documentation and discovery metadata for the hosted Agent Bits service.
Agent Bits MCP questions
How do I add Agent Bits MCP to Claude Code?
Run claude mcp add --transport http agentbits https://agentbits.dev/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Agent Bits MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How do agents pay for premium capabilities?
Paid capabilities use the x402 protocol on the Base network with USDC, allowing agents to pay programmatically without accounts or API keys.
Does the repository contain the actual server implementation?
No, the repository only contains public documentation, discovery metadata, and specifications for the hosted service.