diff --git a/package.json b/package.json
index 8ca773f..c2e597e 100644
--- a/package.json
+++ b/package.json
@@ -1,9 +1,22 @@
 {
   "name": "@code-first-agents/tool",
   "version": "0.1.3",
-  "description": "Code-first agent tool definitions with Zod schemas",
+  "description": "A code-first-agents framework for building deterministic CLI tools that LLM agents can discover, validate, and invoke with zero guesswork. Powered by Zod schemas and structured output contracts.",
+  "keywords": [
+    "ai-agents",
+    "llm-tools",
+    "tool-use",
+    "zod",
+    "cli-tools",
+    "structured-output",
+    "deterministic-tools",
+    "code-first-agents"
+  ],
+  "bugs": {
+    "url": "https://github.com/beogip/code-first-agents-tool/issues"
+  },
   "license": "MIT",
-  "homepage": "https://code-first-agents.com",
+  "homepage": "https://github.com/beogip/code-first-agents-tool#readme",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",