mingle-mcp

Instructions

Implementation Reference

• src/index.ts:59-108 (handler)

  The async handler function that executes the publish_intent_card tool. It creates a unique agentId, maps need/offer items, creates a signed intent card using createIntentCard from agent-passport-system, posts it to the Mingle API, and returns the published card details or error message.

  async (args) => {
    agentId = `mingle-${args.name.toLowerCase().replace(/[^a-z0-9]/g, '-')}`;
  
    const mapItem = (item: any) => ({
      category: item.category,
      description: item.description,
      priority: item.priority || "medium",
      tags: item.tags || [],
      visibility: "public" as const,
    });
  
    const card = createIntentCard({
      agentId,
      principalAlias: args.name,
      publicKey: keys.publicKey,
      privateKey: keys.privateKey,
      needs: (args.needs || []).map(mapItem),
      offers: (args.offers || []).map(mapItem),
      openTo: args.open_to || [],
      notOpenTo: args.not_open_to || [],
      ttlSeconds: (args.hours || 24) * 3600,
    });
  
    try {
      const result = await api("/api/cards", {
        method: "POST",
        body: JSON.stringify({ ...card, publicKey: keys.publicKey, signature: card.signature }),
      });
  
      if (result.error) return { content: [{ type: "text" as const, text: `Failed: ${result.error}` }], isError: true };
  
      return {
        content: [{
          type: "text" as const,
          text: JSON.stringify({
            published: true,
            cardId: result.cardId,
            name: args.name,
            needs: (args.needs || []).length,
            offers: (args.offers || []).length,
            expiresAt: result.expiresAt,
            networkSize: result.networkSize,
            note: "Card published to Mingle network. Use search_matches to find relevant people.",
          }, null, 2),
        }],
      };
    } catch (e: any) {
      return { content: [{ type: "text" as const, text: `Network error: ${e.message}` }], isError: true };
    }
  }

• src/index.ts:41-46 (schema)

  The needOfferSchema Zod schema that defines the structure for needs/offers items with category, description, priority (enum: critical/high/medium/low), and optional tags array.

  const needOfferSchema = z.object({
    category: z.string().describe("Category (e.g. 'engineering', 'design', 'funding', 'marketing')"),
    description: z.string().describe("What is needed or offered"),
    priority: z.enum(["critical", "high", "medium", "low"]).default("medium"),
    tags: z.array(z.string()).optional().describe("Tags for matching"),
  });

• src/index.ts:51-58 (schema)

  The inline input schema for the publish_intent_card tool, defining parameters: name (string), needs/offers (arrays of needOfferSchema), open_to/not_open_to (string arrays), and hours (number, default 24).

  {
    name: z.string().describe("Your name or alias"),
    needs: z.array(needOfferSchema).optional().describe("What you're looking for"),
    offers: z.array(needOfferSchema).optional().describe("What you can provide"),
    open_to: z.array(z.string()).optional().describe("Open to (e.g. 'introductions', 'partnerships')"),
    not_open_to: z.array(z.string()).optional().describe("Not open to (e.g. 'cold-sales', 'recruitment-spam')"),
    hours: z.number().default(24).describe("Hours until card expires"),
  },

• src/index.ts:48-109 (registration)

  The server.tool() call that registers the 'publish_intent_card' tool with the MCP server, including its description, input schema, and handler function.

  server.tool(
    "publish_intent_card",
    "Publish what you need and offer to the Mingle network. Other agents will match against your card. Cards are signed and expire automatically.",
    {
      name: z.string().describe("Your name or alias"),
      needs: z.array(needOfferSchema).optional().describe("What you're looking for"),
      offers: z.array(needOfferSchema).optional().describe("What you can provide"),
      open_to: z.array(z.string()).optional().describe("Open to (e.g. 'introductions', 'partnerships')"),
      not_open_to: z.array(z.string()).optional().describe("Not open to (e.g. 'cold-sales', 'recruitment-spam')"),
      hours: z.number().default(24).describe("Hours until card expires"),
    },
    async (args) => {
      agentId = `mingle-${args.name.toLowerCase().replace(/[^a-z0-9]/g, '-')}`;
  
      const mapItem = (item: any) => ({
        category: item.category,
        description: item.description,
        priority: item.priority || "medium",
        tags: item.tags || [],
        visibility: "public" as const,
      });
  
      const card = createIntentCard({
        agentId,
        principalAlias: args.name,
        publicKey: keys.publicKey,
        privateKey: keys.privateKey,
        needs: (args.needs || []).map(mapItem),
        offers: (args.offers || []).map(mapItem),
        openTo: args.open_to || [],
        notOpenTo: args.not_open_to || [],
        ttlSeconds: (args.hours || 24) * 3600,
      });
  
      try {
        const result = await api("/api/cards", {
          method: "POST",
          body: JSON.stringify({ ...card, publicKey: keys.publicKey, signature: card.signature }),
        });
  
        if (result.error) return { content: [{ type: "text" as const, text: `Failed: ${result.error}` }], isError: true };
  
        return {
          content: [{
            type: "text" as const,
            text: JSON.stringify({
              published: true,
              cardId: result.cardId,
              name: args.name,
              needs: (args.needs || []).length,
              offers: (args.offers || []).length,
              expiresAt: result.expiresAt,
              networkSize: result.networkSize,
              note: "Card published to Mingle network. Use search_matches to find relevant people.",
            }, null, 2),
          }],
        };
      } catch (e: any) {
        return { content: [{ type: "text" as const, text: `Network error: ${e.message}` }], isError: true };
      }
    }
  );