{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_xx7v27yufvcs","handle":"mcp-server-stdio","url":"https://wellknown.network/agents/mcp-server-stdio","links":{"self":"https://wellknown.network/agents/mcp-server-stdio/record.json","html":"https://wellknown.network/agents/mcp-server-stdio","markdown":"https://wellknown.network/agents/mcp-server-stdio/record.md","api":"https://wellknown.network/api/v1/agents/mcp-server-stdio","status":"https://wellknown.network/api/v1/agents/mcp-server-stdio/status","claim":"https://wellknown.network/agents/mcp-server-stdio/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-server-stdio/claim.json","badge":"https://wellknown.network/agents/mcp-server-stdio/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-server-stdio/history","tools":"https://wellknown.network/api/v1/agents/mcp-server-stdio/tools"},"ard":{"identifier":"urn:air::server:mcp-server-stdio","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-server-stdio","summary":"MCP Server for Claude / Stdio transport","description":"# Billing Service MCP Server\n\nA Model Context Protocol (MCP) server that exposes billing information from your StackBill API.\n\n## Setup\n\n### Prerequisites\n- Python 3.14+\n- `uv` package manager (or `pip`)\n\n### Installation\n\n```bash\n# Install dependencies\nuv pip install -r requirements.txt\n```\n\nOr if using pip directly:\n```bash\npip install fastmcp httpx\n```\n\n## Running the Server (stdio transport)\n\nThis project now runs as an MCP stdio server (MCP messages over stdin/stdout). Start the server with:\n\n```bash\npython -m app.main\n```\n\nThe server communicates over standard input/output and is intended to be launched by an MCP-capable client (for example, a desktop assistant or a tool runner that spawns the process and talks MCP over stdio). If you previously used `mcp-inspector` or other HTTP-based tools, note that those expect an HTTP endpoint; for stdio you should configure your MCP client to execute the command above.\n\nFor Claude Desktop or a similar client that accepts a command, use the configuration example in the \"Configuration\" section below to point the client at this process.\n\n### 4. Query Billing Information\n\nIn the mcp-inspector interface, call the `get_billing_summary` tool with your parameters:\n\n**Example 1: Get current month billing**\n```json\n{\n  \"domain_uuid\": \"4ca-d-823\",\n  \"zone_uuid\": \"e5b0-50b-ff-8e2-f2817\"\n}\n```\n\n**Example 2: Get billing for specific date range**\n```json\n{\n  \"domain_uuid\": \"4ca-d-823\",\n  \"zone_uuid\": \"e5b0-50b-ff-8e2-f2817\",\n  \"from_date\": \"03-11-2025 00:00\",\n  \"to_date\": \"20-11-2025 00:00\",\n  \"lang\": \"en\"\n}\n```\n\n## Tool Reference\n\n### `get_billing_summary`\n\nFetch billing summary for a specified date range.\n\n**Parameters:**\n- `domain_uuid` (required): Your domain UUID (e.g., \"4ca-d-823\")\n- `zone_uuid` (required): Your zone UUID (e.g., \"e5b0-50b-ff-8e2-f2817\")\n- `from_date` (optional): Start date in format `DD-MM-YYYY HH:MM`. Defaults to 1st of current month\n- `to_date` (optional): End date in format `DD-MM-YYYY HH:MM`. Defaults to tod…","publisher":null,"homepage":null,"repository":null,"version":"0.1.10","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:mcp-server-stdio","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.859,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"mcp-server-stdio","registry":"pypi","observedAt":"2026-11-09T18:26:03.758Z","publishedAt":"2025-12-06T07:30:05.382018Z","latestVersion":"0.1.10"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-server-stdio","url":"https://pypi.org/project/mcp-server-stdio/","firstSeenAt":"2026-09-10T04:22:31.110Z","fetchedAt":"2026-11-09T18:24:28.019Z","normalizedAt":"2026-11-09T18:24:28.019Z"}]},"firstSeenAt":"2026-09-10T04:22:31.110Z","updatedAt":"2026-11-09T18:26:03.758Z"}