Cisco MCP Pods Server

Instructions

Implementation Reference

• src/podsClient.js:92-95 (handler)

  Core handler function that executes the tool logic by constructing the API endpoint URL and making a GET request via the makeRequest helper.

  async getPodByNumber(collection, number) {
    const url = `${this.baseUrl}/api/v2/pods/${collection}/${number}`;
    return this.makeRequest(url, { method: 'GET' });
  }

• src/index.js:69-84 (schema)

  Input schema definition for the get_pod_by_number tool, specifying collection (string) and number (number) as required parameters.

  name: 'get_pod_by_number',
  description: 'Get a specific pod by its number from a collection. Returns pod details including login credentials, phone numbers, and status.',
  inputSchema: {
    type: 'object',
    properties: {
      collection: {
        type: 'string',
        description: 'Collection name (e.g., ciscolivepods)',
      },
      number: {
        type: 'number',
        description: 'Pod number (e.g., 1, 2, 3)',
      },
    },
    required: ['collection', 'number'],
  },

• src/index.js:245-255 (registration)

  Tool registration and dispatcher in the CallToolRequestSchema handler for the stdio server, which invokes the handler and formats the response.

  case 'get_pod_by_number': {
    const result = await podsClient.getPodByNumber(args.collection, args.number);
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify(result, null, 2),
        },
      ],
    };
  }

• src/server-http.js:245-250 (registration)

  Tool registration and dispatcher in the CallToolRequestSchema handler for the HTTP server, invoking the handler and returning formatted content.

  case 'get_pod_by_number': {
    const result = await podsClient.getPodByNumber(args.collection, args.number);
    return {
      content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
    };
  }

• src/server-http.js:147-156 (schema)

  Input schema definition for the get_pod_by_number tool in the HTTP server, with collection and number parameters.

  name: 'get_pod_by_number',
  description: 'Get a specific pod by its number from a collection.',
  inputSchema: {
    type: 'object',
    properties: {
      collection: { type: 'string', description: 'Collection name' },
      number: { type: 'number', description: 'Pod number' },
    },
    required: ['collection', 'number'],
  },