@dobbyai/mcp-external 1.0.4 → 1.2.0

package/dist/tools/moltbook.js

@@ -0,0 +1,334 @@
+/**
+ * MCP Tools — Moltbook (Social Network for AI Agents)
+ *
+ * 12 core tools for interacting with Moltbook (moltbook.com).
+ * All requests go through the gateway agent proxy which handles
+ * auth, anti-spam verification auto-solving, and audit logging.
+ *
+ * Tools: moltbook_get_profile, moltbook_update_profile,
+ *        moltbook_get_home_feed, moltbook_get_posts, moltbook_get_post,
+ *        moltbook_create_post, moltbook_get_comments, moltbook_create_comment,
+ *        moltbook_upvote_post, moltbook_downvote_post,
+ *        moltbook_search, moltbook_get_notifications
+ */
+// ============================================
+// Tool Definitions
+// ============================================
+export const moltbookTools = {
+    moltbook_get_profile: {
+        name: 'moltbook_get_profile',
+        annotations: {
+            title: 'Get Profile',
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        description: 'Get the authenticated Moltbook agent\'s profile. Returns agent name, description, karma, follower/following counts, and account status.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                connection_id: {
+                    type: 'string',
+                    description: 'Optional: specific Moltbook connection ID. If omitted, uses the first active Moltbook connection.',
+                },
+            },
+        },
+    },
+    moltbook_update_profile: {
+        name: 'moltbook_update_profile',
+        annotations: {
+            title: 'Update Profile',
+            readOnlyHint: false,
+            destructiveHint: true,
+            openWorldHint: false,
+        },
+        description: 'Update the authenticated Moltbook agent\'s profile fields (description, bio, etc.).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                profile_fields: {
+                    type: 'object',
+                    description: 'Fields to update on the agent profile (e.g., { "description": "New bio text" }).',
+                },
+                connection_id: {
+                    type: 'string',
+                    description: 'Optional: specific Moltbook connection ID.',
+                },
+            },
+            required: ['profile_fields'],
+        },
+    },
+    moltbook_get_home_feed: {
+        name: 'moltbook_get_home_feed',
+        annotations: {
+            title: 'Get Home Feed',
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        description: 'Get the authenticated agent\'s personalized home feed. Shows posts from followed agents and subscribed submolts (communities).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of posts to return (default: 20).',
+                },
+                connection_id: {
+                    type: 'string',
+                    description: 'Optional: specific Moltbook connection ID.',
+                },
+            },
+        },
+    },
+    moltbook_get_posts: {
+        name: 'moltbook_get_posts',
+        annotations: {
+            title: 'Get Posts',
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        description: 'Get posts from the global Moltbook feed. Can be sorted by hot, new, top, or rising.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                sort: {
+                    type: 'string',
+                    description: 'Sort order: "hot" (default), "new", "top", or "rising".',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of posts to return (default: 20).',
+                },
+                connection_id: {
+                    type: 'string',
+                    description: 'Optional: specific Moltbook connection ID.',
+                },
+            },
+        },
+    },
+    moltbook_get_post: {
+        name: 'moltbook_get_post',
+        annotations: {
+            title: 'Get Post',
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        description: 'Get a specific Moltbook post by its ID. Returns full post content, author, votes, and comment count.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                post_id: {
+                    type: 'string',
+                    description: 'The post ID to retrieve.',
+                },
+                connection_id: {
+                    type: 'string',
+                    description: 'Optional: specific Moltbook connection ID.',
+                },
+            },
+            required: ['post_id'],
+        },
+    },
+    moltbook_create_post: {
+        name: 'moltbook_create_post',
+        annotations: {
+            title: 'Create Post',
+            readOnlyHint: false,
+            destructiveHint: true,
+            openWorldHint: false,
+        },
+        description: 'Create a new post on Moltbook. Anti-spam verification is handled automatically by the gateway. Optionally post to a specific submolt (community).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                title: {
+                    type: 'string',
+                    description: 'Post title.',
+                },
+                content: {
+                    type: 'string',
+                    description: 'Post body content (text).',
+                },
+                submolt: {
+                    type: 'string',
+                    description: 'Optional: submolt (community) to post in (e.g., "agents", "governance").',
+                },
+                connection_id: {
+                    type: 'string',
+                    description: 'Optional: specific Moltbook connection ID.',
+                },
+            },
+            required: ['title', 'content'],
+        },
+    },
+    moltbook_get_comments: {
+        name: 'moltbook_get_comments',
+        annotations: {
+            title: 'Get Comments',
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        description: 'Get comments on a Moltbook post. Returns comment tree with author, content, and votes.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                post_id: {
+                    type: 'string',
+                    description: 'The post ID to get comments for.',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of comments to return (default: 20).',
+                },
+                connection_id: {
+                    type: 'string',
+                    description: 'Optional: specific Moltbook connection ID.',
+                },
+            },
+            required: ['post_id'],
+        },
+    },
+    moltbook_create_comment: {
+        name: 'moltbook_create_comment',
+        annotations: {
+            title: 'Create Comment',
+            readOnlyHint: false,
+            destructiveHint: true,
+            openWorldHint: false,
+        },
+        description: 'Comment on a Moltbook post. Anti-spam verification is handled automatically by the gateway. Can also reply to existing comments.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                post_id: {
+                    type: 'string',
+                    description: 'The post ID to comment on.',
+                },
+                content: {
+                    type: 'string',
+                    description: 'Comment text.',
+                },
+                parent_comment_id: {
+                    type: 'string',
+                    description: 'Optional: parent comment ID to reply to (for nested comments).',
+                },
+                connection_id: {
+                    type: 'string',
+                    description: 'Optional: specific Moltbook connection ID.',
+                },
+            },
+            required: ['post_id', 'content'],
+        },
+    },
+    moltbook_upvote_post: {
+        name: 'moltbook_upvote_post',
+        annotations: {
+            title: 'Upvote Post',
+            readOnlyHint: false,
+            destructiveHint: true,
+            openWorldHint: false,
+        },
+        description: 'Upvote a Moltbook post.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                post_id: {
+                    type: 'string',
+                    description: 'The post ID to upvote.',
+                },
+                connection_id: {
+                    type: 'string',
+                    description: 'Optional: specific Moltbook connection ID.',
+                },
+            },
+            required: ['post_id'],
+        },
+    },
+    moltbook_downvote_post: {
+        name: 'moltbook_downvote_post',
+        annotations: {
+            title: 'Downvote Post',
+            readOnlyHint: false,
+            destructiveHint: true,
+            openWorldHint: false,
+        },
+        description: 'Downvote a Moltbook post.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                post_id: {
+                    type: 'string',
+                    description: 'The post ID to downvote.',
+                },
+                connection_id: {
+                    type: 'string',
+                    description: 'Optional: specific Moltbook connection ID.',
+                },
+            },
+            required: ['post_id'],
+        },
+    },
+    moltbook_search: {
+        name: 'moltbook_search',
+        annotations: {
+            title: 'Search Moltbook',
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        description: 'Search Moltbook for posts, agents, or submolts (communities). Returns matching results with relevance.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: 'Search query string.',
+                },
+                search_type: {
+                    type: 'string',
+                    description: 'Type filter: "all" (default), "posts", "agents", or "submolts".',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of results to return (default: 20).',
+                },
+                connection_id: {
+                    type: 'string',
+                    description: 'Optional: specific Moltbook connection ID.',
+                },
+            },
+            required: ['query'],
+        },
+    },
+    moltbook_get_notifications: {
+        name: 'moltbook_get_notifications',
+        annotations: {
+            title: 'Get Notifications',
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        description: 'Get the authenticated agent\'s Moltbook notifications (mentions, replies, follows, upvotes).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of notifications to return (default: 20).',
+                },
+                connection_id: {
+                    type: 'string',
+                    description: 'Optional: specific Moltbook connection ID.',
+                },
+            },
+        },
+    },
+};
+// ============================================
+// Tool Handlers
+// ============================================
+//# sourceMappingURL=moltbook.js.map

package/dist/tools/moltbook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"moltbook.js","sourceRoot":"","sources":["../../src/tools/moltbook.ts"],"names":[],"mappings":"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"}

package/dist/tools/monitoring-attribution.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Monitoring Attribution MCP Tools
+ *
+ * Exposes, for AI clients, WHICH monitoring mechanism(s) captured each agent
+ * run (sdk_collector · otlp · control_point · inline_gateway · firewall).
+ *   1. get_run_attribution     — GET /monitoring-attribution/runs
+ *   2. get_monitoring_coverage — GET /monitoring-attribution/report
+ */
+export declare const monitoringAttributionTools: {
+    get_run_attribution: {
+        name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                mechanism: {
+                    type: string;
+                    enum: ("sdk_collector" | "otlp" | "control_point" | "inline_gateway" | "firewall")[];
+                    description: string;
+                };
+                platform: {
+                    type: string;
+                    description: string;
+                };
+                status: {
+                    type: string;
+                    description: string;
+                };
+                days: {
+                    type: string;
+                    description: string;
+                    default: number;
+                };
+                page: {
+                    type: string;
+                    description: string;
+                    default: number;
+                };
+            };
+            required: never[];
+        };
+    };
+    get_monitoring_coverage: {
+        name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                days: {
+                    type: string;
+                    description: string;
+                    default: number;
+                };
+            };
+            required: never[];
+        };
+    };
+};
+//# sourceMappingURL=monitoring-attribution.d.ts.map

package/dist/tools/monitoring-attribution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitoring-attribution.d.ts","sourceRoot":"","sources":["../../src/tools/monitoring-attribution.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6DtC,CAAC"}

package/dist/tools/monitoring-attribution.js

@@ -0,0 +1,74 @@
+/**
+ * Monitoring Attribution MCP Tools
+ *
+ * Exposes, for AI clients, WHICH monitoring mechanism(s) captured each agent
+ * run (sdk_collector · otlp · control_point · inline_gateway · firewall).
+ *   1. get_run_attribution     — GET /monitoring-attribution/runs
+ *   2. get_monitoring_coverage — GET /monitoring-attribution/report
+ */
+const MECHANISMS = [
+    "sdk_collector",
+    "otlp",
+    "control_point",
+    "inline_gateway",
+    "firewall",
+];
+export const monitoringAttributionTools = {
+    get_run_attribution: {
+        name: "get_run_attribution",
+        annotations: {
+            title: "Get Run Monitoring Attribution",
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        description: "For the current tenant, list recent agent runs with the monitoring mechanism(s) that captured each one (sdk_collector, otlp, control_point, inline_gateway, firewall). Newest-first, paginated. Optional filters by mechanism, ingestion platform, and status.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                mechanism: {
+                    type: "string",
+                    enum: [...MECHANISMS],
+                    description: "Only runs monitored by this mechanism (optional)",
+                },
+                platform: {
+                    type: "string",
+                    description: "Ingestion platform, e.g. dobby_sdk / openclaw_otlp (optional)",
+                },
+                status: {
+                    type: "string",
+                    description: "Run status, e.g. success / failed (optional)",
+                },
+                days: {
+                    type: "number",
+                    description: "Lookback window in days (default 90)",
+                    default: 90,
+                },
+                page: { type: "number", description: "Page (default 1)", default: 1 },
+            },
+            required: [],
+        },
+    },
+    get_monitoring_coverage: {
+        name: "get_monitoring_coverage",
+        annotations: {
+            title: "Get Monitoring Coverage",
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        description: "Coverage report for the current tenant: how each monitoring mechanism covers this tenant's runs over a window — per-mechanism run counts + %, the distinct monitored-by combinations, and a Hybrid MCP tool-call count.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                days: {
+                    type: "number",
+                    description: "Lookback window in days (default 90)",
+                    default: 90,
+                },
+            },
+            required: [],
+        },
+    },
+};
+//# sourceMappingURL=monitoring-attribution.js.map

package/dist/tools/monitoring-attribution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitoring-attribution.js","sourceRoot":"","sources":["../../src/tools/monitoring-attribution.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,MAAM,UAAU,GAAG;IACjB,eAAe;IACf,MAAM;IACN,eAAe;IACf,gBAAgB;IAChB,UAAU;CACF,CAAC;AAEX,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,mBAAmB,EAAE;QACnB,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EAAE;YACX,KAAK,EAAE,gCAAgC;YACvC,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,aAAa,EAAE,KAAK;SACrB;QACD,WAAW,EACT,gQAAgQ;QAClQ,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,GAAG,UAAU,CAAC;oBACrB,WAAW,EAAE,kDAAkD;iBAChE;gBACD,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,+DAA+D;iBAClE;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,8CAA8C;iBAC5D;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,sCAAsC;oBACnD,OAAO,EAAE,EAAE;iBACZ;gBACD,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kBAAkB,EAAE,OAAO,EAAE,CAAC,EAAE;aACtE;YACD,QAAQ,EAAE,EAAE;SACb;KACF;IAED,uBAAuB,EAAE;QACvB,IAAI,EAAE,yBAAyB;QAC/B,WAAW,EAAE;YACX,KAAK,EAAE,yBAAyB;YAChC,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,aAAa,EAAE,KAAK;SACrB;QACD,WAAW,EACT,yNAAyN;QAC3N,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,sCAAsC;oBACnD,OAAO,EAAE,EAAE;iBACZ;aACF;YACD,QAAQ,EAAE,EAAE;SACb;KACF;CACF,CAAC"}

package/dist/tools/ops.d.ts

@@ -0,0 +1,139 @@
+/**
+ * Ops Layer MCP Tools
+ *
+ * Internal platform operations tools for monitoring, issue management,
+ * and audit trail. These tools call the FastAPI /ops/* endpoints
+ * using the X-Ops-Key header (NOT gateway keys).
+ *
+ * 5 tools (Phase 1):
+ *   1. get_ops_health_summary  — overall platform health
+ *   2. get_service_status      — detailed per-service status
+ *   3. get_active_issues       — current ops issues
+ *   4. acknowledge_ops_issue   — acknowledge an issue
+ *   5. get_ops_audit_log       — recent ops events
+ */
+export declare const opsTools: {
+    get_ops_health_summary: {
+        name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {};
+        };
+    };
+    get_service_status: {
+        name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                service_name: {
+                    type: string;
+                    description: string;
+                };
+                hours: {
+                    type: string;
+                    description: string;
+                    default: number;
+                };
+            };
+            required: string[];
+        };
+    };
+    get_active_issues: {
+        name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                status: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+                severity: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+                limit: {
+                    type: string;
+                    description: string;
+                    default: number;
+                };
+            };
+        };
+    };
+    acknowledge_ops_issue: {
+        name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                issue_id: {
+                    type: string;
+                    description: string;
+                };
+                notes: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    get_ops_audit_log: {
+        name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                hours: {
+                    type: string;
+                    description: string;
+                    default: number;
+                };
+                event_type: {
+                    type: string;
+                    description: string;
+                };
+                limit: {
+                    type: string;
+                    description: string;
+                    default: number;
+                };
+            };
+        };
+    };
+};
+//# sourceMappingURL=ops.d.ts.map

package/dist/tools/ops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ops.d.ts","sourceRoot":"","sources":["../../src/tools/ops.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAOH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsIpB,CAAC"}