exponential-mcp 0.4.0 → 0.5.0

package/dist/index.js

@@ -260,13 +260,54 @@ const TOOLS = [
     },
     {
         name: 'get_goals',
-        description: 'List OKRs (Objectives and Key Results) with their progress',
+        description: "List objectives (goals). Each objective carries its linked projects, which is how work ladders up to an OKR: every action has a projectId. Objectives have INTEGER ids — key results, which are separate, have CUIDs (see get_key_results). Use tree: true for the annual → quarterly cascade.",
         inputSchema: {
             type: 'object',
             properties: {
                 workspaceId: {
                     type: 'string',
-                    description: 'Optional workspace ID'
+                    description: 'Optional workspace ID. With it the list is workspace-wide (every member\'s objectives); without it you get your own.'
+                },
+                period: {
+                    type: 'string',
+                    description: 'Optional period filter, e.g. "Q3-2026" or "Annual-2026"'
+                },
+                status: {
+                    type: 'string',
+                    description: 'Optional status: planned, active, completed, archived, on-hold'
+                },
+                tree: {
+                    type: 'boolean',
+                    description: 'Return objectives nested parent → child (up to 5 levels), each with its projects and key results, instead of a flat list'
+                }
+            }
+        }
+    },
+    {
+        name: 'get_key_results',
+        description: "List key results — the measurable half of an OKR. By default groups them under their objectives (the richest read: one call for 'how is the quarter going'). Pass flat: true for a bare list. Key result ids are CUIDs; the goalId tying one to its objective is an integer.",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                workspaceId: {
+                    type: 'string',
+                    description: "Optional workspace ID. With it the list is workspace-wide (every member's key results); without it you get your own."
+                },
+                period: {
+                    type: 'string',
+                    description: 'Optional period filter, e.g. "Q3-2026"'
+                },
+                goalId: {
+                    type: 'number',
+                    description: 'Optional objective ID (an integer). Only applies with flat: true.'
+                },
+                status: {
+                    type: 'string',
+                    description: 'Optional status: not-started, on-track, at-risk, off-track, achieved. Only applies with flat: true.'
+                },
+                flat: {
+                    type: 'boolean',
+                    description: 'Return a flat list of key results rather than grouping them by objective'
                 }
             }
         }
@@ -465,10 +506,17 @@ async function main() {
                         ],
                     };
                 }
+                // Goes through the SDK's GoalsApi rather than a raw tRPC path. The old
+                // implementation called `goal.list`, which does not exist — the tool
+                // hard-errored with `No procedure found on path "goal.list"` on every
+                // invocation.
                 case 'get_goals': {
-                    const goals = await trpcClient.goal.list.query({
-                        workspaceId: args?.workspaceId,
-                    });
+                    const workspaceId = args?.workspaceId;
+                    const period = args?.period;
+                    const status = args?.status;
+                    const goals = args?.tree
+                        ? await client.goals.tree({ workspaceId, status })
+                        : await client.goals.list({ workspaceId, period, status });
                     return {
                         content: [
                             {
@@ -478,6 +526,26 @@ async function main() {
                         ],
                     };
                 }
+                case 'get_key_results': {
+                    const workspaceId = args?.workspaceId;
+                    const period = args?.period;
+                    const keyResults = args?.flat
+                        ? await client.goals.keyResults.list({
+                            workspaceId,
+                            period,
+                            goalId: args?.goalId,
+                            status: args?.status,
+                        })
+                        : await client.goals.keyResults.byObjective({ workspaceId, period });
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: JSON.stringify(keyResults, null, 2),
+                            },
+                        ],
+                    };
+                }
                 case 'search': {
                     const results = await trpcClient.search.global.query({
                         query: args?.query,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "exponential-mcp",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "MCP server for Exponential - connect Claude to your projects, actions, and goals",
   "main": "dist/index.js",
   "bin": {
@@ -26,7 +26,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.30.0",
     "commander": "^12.0.0",
-    "exponential-sdk": "^1.11.0",
+    "exponential-sdk": "^1.12.0",
     "zod": "^3.22.0"
   },
   "devDependencies": {

package/dist/api.d.ts

@@ -1,84 +0,0 @@
-/**
- * Exponential API Client
- * Handles authenticated requests to the Exponential API
- */
-export interface ExponentialConfig {
-    apiKey: string;
-    baseUrl?: string;
-}
-export interface Project {
-    id: string;
-    name: string;
-    description?: string;
-    status: string;
-    priority: string;
-    progress: number;
-}
-export interface Action {
-    id: string;
-    name: string;
-    description?: string;
-    status: string;
-    priority: string;
-    dueDate?: string;
-    projectId?: string;
-    project?: {
-        name: string;
-    };
-}
-export interface Goal {
-    id: number;
-    title: string;
-    description?: string;
-    period?: string;
-    keyResults: KeyResult[];
-}
-export interface KeyResult {
-    id: string;
-    title: string;
-    targetValue?: number;
-    currentValue?: number;
-    status: string;
-}
-export interface Workspace {
-    id: string;
-    name: string;
-    slug: string;
-}
-export declare class ExponentialAPI {
-    private apiKey;
-    private baseUrl;
-    constructor(config: ExponentialConfig);
-    private request;
-    private trpcQuery;
-    private trpcMutation;
-    getWorkspaces(): Promise<Workspace[]>;
-    getProjects(workspaceId?: string): Promise<Project[]>;
-    getProject(id: string): Promise<Project>;
-    getActions(params?: {
-        projectId?: string;
-        status?: string;
-    }): Promise<Action[]>;
-    createAction(data: {
-        name: string;
-        description?: string;
-        projectId?: string;
-        priority?: string;
-        dueDate?: string;
-    }): Promise<Action>;
-    updateAction(id: string, data: {
-        name?: string;
-        status?: string;
-        priority?: string;
-        dueDate?: string;
-    }): Promise<Action>;
-    completeAction(id: string): Promise<Action>;
-    getGoals(workspaceId?: string): Promise<Goal[]>;
-    getGoal(id: number): Promise<Goal>;
-    quickCreateAction(text: string): Promise<Action>;
-    search(query: string): Promise<{
-        projects: Project[];
-        actions: Action[];
-        goals: Goal[];
-    }>;
-}

package/dist/api.js

@@ -1,82 +0,0 @@
-/**
- * Exponential API Client
- * Handles authenticated requests to the Exponential API
- */
-const DEFAULT_BASE_URL = 'https://www.exponential.im';
-export class ExponentialAPI {
-    apiKey;
-    baseUrl;
-    constructor(config) {
-        this.apiKey = config.apiKey;
-        this.baseUrl = config.baseUrl || DEFAULT_BASE_URL;
-    }
-    async request(endpoint, options = {}) {
-        const url = `${this.baseUrl}${endpoint}`;
-        const response = await fetch(url, {
-            ...options,
-            headers: {
-                'Authorization': `Bearer ${this.apiKey}`,
-                'Content-Type': 'application/json',
-                ...options.headers,
-            },
-        });
-        if (!response.ok) {
-            const error = await response.text();
-            throw new Error(`Exponential API error (${response.status}): ${error}`);
-        }
-        return response.json();
-    }
-    // tRPC-style calls
-    async trpcQuery(procedure, input) {
-        const inputStr = input ? encodeURIComponent(JSON.stringify(input)) : '';
-        const url = `/api/trpc/${procedure}${inputStr ? `?input=${inputStr}` : ''}`;
-        return this.request(url).then(r => r.result.data);
-    }
-    async trpcMutation(procedure, input) {
-        const url = `/api/trpc/${procedure}`;
-        return this.request(url, {
-            method: 'POST',
-            body: JSON.stringify(input),
-        }).then(r => r.result.data);
-    }
-    // === Workspace ===
-    async getWorkspaces() {
-        return this.trpcQuery('workspace.list');
-    }
-    // === Projects ===
-    async getProjects(workspaceId) {
-        return this.trpcQuery('project.list', { workspaceId });
-    }
-    async getProject(id) {
-        return this.trpcQuery('project.get', { id });
-    }
-    // === Actions ===
-    async getActions(params) {
-        return this.trpcQuery('action.list', params);
-    }
-    async createAction(data) {
-        return this.trpcMutation('action.create', data);
-    }
-    async updateAction(id, data) {
-        return this.trpcMutation('action.update', { id, ...data });
-    }
-    async completeAction(id) {
-        return this.updateAction(id, { status: 'COMPLETED' });
-    }
-    // === Goals (OKRs) ===
-    async getGoals(workspaceId) {
-        return this.trpcQuery('goal.list', { workspaceId });
-    }
-    async getGoal(id) {
-        return this.trpcQuery('goal.get', { id });
-    }
-    // === Quick Actions ===
-    async quickCreateAction(text) {
-        // Uses natural language parsing (dates, project names, etc.)
-        return this.trpcMutation('action.quickCreate', { text });
-    }
-    // === Search ===
-    async search(query) {
-        return this.trpcQuery('search.global', { query });
-    }
-}