{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_ummduhejtnug","handle":"smarter-mcp","url":"https://wellknown.network/agents/smarter-mcp","links":{"self":"https://wellknown.network/agents/smarter-mcp/record.json","html":"https://wellknown.network/agents/smarter-mcp","markdown":"https://wellknown.network/agents/smarter-mcp/record.md","api":"https://wellknown.network/api/v1/agents/smarter-mcp","status":"https://wellknown.network/api/v1/agents/smarter-mcp/status","claim":"https://wellknown.network/agents/smarter-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/smarter-mcp/claim.json","badge":"https://wellknown.network/agents/smarter-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:smarter-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"smarter-mcp","summary":"Turn any Python codebase into a production-grade MCP server with zero friction.","description":"<img width=\"770\" height=\"159\" alt=\"image\" src=\"https://github.com/user-attachments/assets/2be86ef1-e7f6-4fc4-8b4c-89ab3b98124a\" />\n# Smarter-MCP\n\n> **The highest-level Python framework for building, generating, and running MCP servers.**\n\n*If Python can call it, Smarter-MCP can serve it.*\n\n```bash\npip install smarter-mcp\n```\n\n---\nSmarter-MCP sits on top of FastMCP and acts as the orchestration layer that handles everything a developer shouldn't have to think about:\n\n## Three ways in, one runtime\n\n### 1. Existing code — zero rewrites\n\nPoint at any module you already have (or anything on PyPI):\n\n```python\nimport pandas as pd\nfrom smarter_mcp import SmarterMCP\n\napp = SmarterMCP(\"data-tools\")\napp.discover_module(pd.DataFrame, include=[\"describe\", \"head\", \"tail\"])\napp.run()\n```\n\nOr scan an entire local codebase from the CLI:\n\n```bash\nsmarter-mcp serve ./src/mylib\n```\n\nThe dual-pass engine (AST + inspect) reads your signatures, builds JSON schemas, and serves them. Nothing to rewrite.\n\n---\n\n### 2. Stateful class tools\n\nWhen your tools need shared state (a DB connection, an API client, an ML model loaded once), `@toolkit` manages it:\n\n```python\nfrom smarter_mcp import tool, toolkit\n\n@toolkit(lifecycle=\"session\")\nclass DatabaseClient:\n    def __init__(self, host: str = \"localhost\", port: int = 5432):\n        self.conn = connect(host, port)\n\n    @tool(name=\"run_query\")\n    def query(self, sql: str) -> list[dict]:\n        \"\"\"Execute a SQL query and return results.\"\"\"\n        return self.conn.execute(sql).fetchall()\n```\n\nOne instance per session. Constructor args injected from config. Session instances are evicted via bounded LRU (max 256 entries) with best-effort resource cleanup (`close()`/`__exit__`) on eviction. You write the class, Smarter-MCP handles the plumbing.\n\n---\n\n### 3. ✍️ Fresh tools from scratch\n\n```python\nfrom smarter_mcp import SmarterMCP, tool, resource\n\napp = SmarterMCP(\"my-server\")\n\n@tool(\"Greet a user by name\")\ndef greet(name: str) -> str:\n    return f\"He…","publisher":{"name":"logic-OT","url":null},"homepage":"https://github.com/logic-OT/smarter-mcp","repository":"https://github.com/logic-OT/smarter-mcp","version":"0.1.4","license":null,"protocols":["mcp"],"tags":["agents","ai","fastmcp","mcp","model-context-protocol"],"pricing":null,"endpoints":[{"url":"pypi:smarter-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"data.database","name":"Databases","confidence":0.733,"provenance":"derived"}],"categories":["data"],"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":"smarter-mcp","registry":"pypi","observedAt":"2026-09-10T12:23:36.215Z","publishedAt":"2026-06-13T00:32:35.998880Z","latestVersion":"0.1.4"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"smarter-mcp","url":"https://pypi.org/project/smarter-mcp/","firstSeenAt":"2026-09-10T12:22:36.989Z","fetchedAt":"2026-09-10T12:22:36.989Z","normalizedAt":"2026-09-10T12:22:36.989Z"}]},"firstSeenAt":"2026-09-10T12:22:36.989Z","updatedAt":"2026-09-10T12:23:36.215Z"}