`get_users`

Pack: jsonplaceholder · Endpoint: https://gateway.pipeworx.io/jsonplaceholder/mcp

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/get_users for the schema, then POST the same URL with its arguments for the data.

Fetch all fake users for testing. Returns name, username, email, address, phone, website, and company details.

Example call

Arguments

{}

curl

curl -X POST https://gateway.pipeworx.io/jsonplaceholder/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_users","arguments":{}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('get_users', {});

Response shape

Always returns: count, users

Field	Type	Description
`count`	number	Number of users returned
`users`	array	Array of fake users

Full JSON Schema

{
  "type": "object",
  "properties": {
    "count": {
      "type": "number",
      "description": "Number of users returned"
    },
    "users": {
      "type": "array",
      "description": "Array of fake users",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "description": "User ID"
          },
          "name": {
            "type": "string",
            "description": "User's full name"
          },
          "username": {
            "type": "string",
            "description": "User's username"
          },
          "email": {
            "type": "string",
            "description": "User's email address"
          },
          "phone": {
            "type": "string",
            "description": "User's phone number"
          },
          "website": {
            "type": "string",
            "description": "User's website URL"
          },
          "address": {
            "type": "object",
            "description": "User's address information",
            "properties": {
              "street": {
                "type": "string",
                "description": "Street address"
              },
              "suite": {
                "type": "string",
                "description": "Suite or apartment number"
              },
              "city": {
                "type": "string",
                "description": "City name"
              },
              "zipcode": {
                "type": "string",
                "description": "Postal code"
              },
              "geo": {
                "type": "object",
                "description": "Geographic coordinates",
                "properties": {
                  "lat": {
                    "type": "number",
                    "description": "Latitude"
                  },
                  "lng": {
                    "type": "number",
                    "description": "Longitude"
                  }
                },
                "required": [
                  "lat",
                  "lng"
                ]
              }
            },
            "required": [
              "street",
              "suite",
              "city",
              "zipcode",
              "geo"
            ]
          },
          "company": {
            "type": "object",
            "description": "User's company information",
            "properties": {
              "name": {
                "type": "string",
                "description": "Company name"
              },
              "catch_phrase": {
                "type": "string",
                "description": "Company catch phrase"
              },
              "bs": {
                "type": "string",
                "description": "Company business statement"
              }
            },
            "required": [
              "name",
              "catch_phrase",
              "bs"
            ]
          }
        },
        "required": [
          "id",
          "name",
          "username",
          "email",
          "phone",
          "website",
          "address",
          "company"
        ]
      }
    }
  },
  "required": [
    "count",
    "users"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "jsonplaceholder": {
      "url": "https://gateway.pipeworx.io/jsonplaceholder/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

get_users