@taiga-ai/mcp-server 0.6.0-rc.393 → 0.7.0-dev.395

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taiga-ai/mcp-server",
-  "version": "0.6.0-rc.393",
+  "version": "0.7.0-dev.395",
   "description": "MCP server for Taiga -- gives AI assistants access to documents and products",
   "type": "module",
   "main": "./dist/index.js",

package/src/client.test.ts

@@ -338,6 +338,25 @@ describe('TaigaClient', () => {
       expect(url.searchParams.get('repositoryHost')).toBe('https://github.com');
     });
 
+    it('should read a product document from the asked timeline and list one timeline at a time', async () => {
+      const spy = stubFetch(200, { data: [] });
+      const client = makeClient();
+
+      await client.getProductDocument('p1', 'architecture', 'reality');
+      await client.getProductDocument('p1', 'architecture');
+      await client.listProductDocuments('p1', { origin: 'reality', limit: 100 });
+
+      const paths = spy.mock.calls.map((c) => {
+        const url = new URL(c[0] as string);
+        return url.pathname + url.search;
+      });
+      expect(paths).toEqual([
+        '/v1/products/p1/documents/architecture?origin=reality',
+        '/v1/products/p1/documents/architecture',
+        '/v1/products/p1/documents?origin=reality&limit=100',
+      ]);
+    });
+
     it('should GET a single backlog item by id (flat path)', async () => {
       const spy = stubFetch(200, { data: { id: 'item-1' } });
 

package/src/client.ts

@@ -137,6 +137,7 @@ export class TaigaClient {
   async listProducts(opts?: {
     factoryId?: string | undefined;
     status?: string | undefined;
+    slug?: string | undefined;
     repository?: string | undefined;
     repositoryHost?: string | undefined;
     limit?: number | undefined;
@@ -145,6 +146,7 @@ export class TaigaClient {
     const params = new URLSearchParams();
     if (opts?.factoryId) params.set('factoryId', opts.factoryId);
     if (opts?.status) params.set('status', opts.status);
+    if (opts?.slug) params.set('slug', opts.slug);
     if (opts?.repository) params.set('repository', opts.repository);
     if (opts?.repositoryHost) params.set('repositoryHost', opts.repositoryHost);
     if (opts?.limit) params.set('limit', String(opts.limit));
@@ -230,8 +232,9 @@ export class TaigaClient {
   // Product Documents
   // ---------------------------------------------------------------------------
 
-  async listProductDocuments(productId: string, opts?: { limit?: number | undefined }) {
+  async listProductDocuments(productId: string, opts?: { origin?: string | undefined; limit?: number | undefined }) {
     const params = new URLSearchParams();
+    if (opts?.origin) params.set('origin', opts.origin);
     if (opts?.limit) params.set('limit', String(opts.limit));
     const qs = params.toString();
     return this.request<{ data: unknown[]; nextCursor: string | null }>(
@@ -240,8 +243,9 @@ export class TaigaClient {
     );
   }
 
-  async getProductDocument(productId: string, type: string) {
-    return this.request<{ data: unknown }>('GET', `/products/${seg(productId)}/documents/${seg(type)}`);
+  async getProductDocument(productId: string, type: string, origin?: string) {
+    const qs = origin ? `?${new URLSearchParams({ origin })}` : '';
+    return this.request<{ data: unknown }>('GET', `/products/${seg(productId)}/documents/${seg(type)}${qs}`);
   }
 
   // ---------------------------------------------------------------------------
@@ -307,6 +311,10 @@ export class TaigaClient {
   // Factories
   // ---------------------------------------------------------------------------
 
+  async getFactory(id: string) {
+    return this.request<{ data: unknown }>('GET', `/factories/${seg(id)}`);
+  }
+
   async listFactories(opts?: { limit?: number | undefined }) {
     const params = new URLSearchParams();
     if (opts?.limit) params.set('limit', String(opts.limit));

package/src/config.test.ts

@@ -17,7 +17,7 @@ describe('readConfig', () => {
   it('defaults the API URL', () => {
     vi.stubEnv('TAIGA_API_KEY', 'taiga_sk_live_test');
     vi.stubEnv('TAIGA_API_URL', undefined);
-    expect(readConfig()).toEqual({ apiKey: 'taiga_sk_live_test', apiUrl: 'https://api.taiga.app' });
+    expect(readConfig()).toEqual({ apiKey: 'taiga_sk_live_test', apiUrl: 'https://api.eu.tai.ga' });
     vi.stubEnv('TAIGA_API_URL', 'http://localhost:3001');
     expect(readConfig()?.apiUrl).toBe('http://localhost:3001');
   });

package/src/config.ts

@@ -5,7 +5,10 @@ import { z } from 'zod';
  * at startup.
  */
 
-const DEFAULT_API_URL = 'https://api.taiga.app';
+// The production API behind the custom domain in infra/dns.tf. The old
+// default, api.taiga.app, never resolved, so every install that followed the
+// README without TAIGA_API_URL failed on its first call.
+const DEFAULT_API_URL = 'https://api.eu.tai.ga';
 
 const envSchema = z.object({
   TAIGA_API_KEY: z.string().min(1),

package/src/index.ts

@@ -5,13 +5,14 @@ import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
 import { TaigaClient } from './client.js';
 import { readConfig } from './config.js';
 import { registerAllTools } from './tools/index.js';
+import { SERVER_INSTRUCTIONS } from './tools/instructions.js';
 import { SERVER_VERSION } from './version.js';
 
 async function main() {
   const config = readConfig();
   if (!config) {
     console.error('Error: TAIGA_API_KEY environment variable is required.');
-    console.error('Create an API key at https://app.taiga.app/settings/api-keys');
+    console.error('Create one at https://eu.tai.ga under Settings > Account > API keys.');
     process.exit(1);
   }
 
@@ -32,35 +33,7 @@ async function main() {
       version: SERVER_VERSION,
     },
     {
-      instructions: [
-        'You have access to Taiga -- a policy-aware software development platform.',
-        "Taiga provides your organization's engineering knowledge base:",
-        '',
-        '**Company policies** (taiga_list_documents / taiga_get_document):',
-        'Security, data privacy, SDLC, architecture, and compliance rules that apply to all code.',
-        'Read the relevant policy BEFORE writing code that touches security, data handling, or infrastructure.',
-        '',
-        '**Factory instructions** (taiga_list_factory_documents / taiga_get_factory_document):',
-        "A factory's standing guidance: domain context (ubiquitous language, entities, business rules),",
-        'tech preferences (approved stack, patterns), and conventions. Read these to understand HOW this factory builds software.',
-        '',
-        '**Product documents** (taiga_list_product_documents / taiga_get_product_document):',
-        "Specification (what to build), architecture (how it's designed), threat model (security risks),",
-        'technology decisions, and data flow. Read these to understand the specific product.',
-        '',
-        '**Backlog and runs** (taiga_list_backlog_items / taiga_get_backlog_item / taiga_list_builds / taiga_get_build):',
-        "The product's initiatives with their acceptance criteria, and what Taiga's coding agent already built",
-        'for them: runs, steps, commits and pull requests.',
-        '',
-        'Workflow: Inside a git checkout, start with taiga_resolve_product on the remote URL to find the product.',
-        'Otherwise use taiga_list_factories and taiga_list_products. Then read the factory instructions,',
-        "the product's specification and architecture, and the backlog item you are working on.",
-        '',
-        'When you notice a policy or factory instructions are outdated, fix the section with',
-        'taiga_update_document or taiga_update_factory_document. That saves a draft nobody follows yet;',
-        'publish it with taiga_publish_document or taiga_publish_factory_document only when the person asks.',
-        'This keeps the knowledge base accurate for everyone.',
-      ].join('\n'),
+      instructions: SERVER_INSTRUCTIONS,
     }
   );