Wapiworld WhatsApp API

Check your WhatsApp numbers, connection status and webhooks, and send a text when you confirm.

사용해야 할까요

품질 및 안전성

A
설명 품질
96%
스키마 완전성
96%
이름 품질
100%
오염 위험
100%
권한 일치
90%
프로토콜 준수
100%

발견 사항 (2)

  • LOWTool 'list_projects' description lacks action verblist_projects에서
  • LOWTool 'list_webhook_subscriptions' suggests web access but openWorldHint=falselist_webhook_subscriptions에서

도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.

컨텍스트 비용

~3,990토큰 (도구 정의)
~4.7 KB일반적인 응답 크기
상당한 주의 영향 (128k 컨텍스트의 3.12%)

이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.

설치

원클릭 설치

`claude_desktop_config.json` 파일에 다음을 추가하세요:

{
  "mcpServers": {
    "wapiworld": {
      "url": "https://mcp.wapiworld.com/mcp"
    }
  }
}

원격 엔드포인트

https://mcp.wapiworld.com/mcpstreamable-http

할 수 있는 일

도구 목록

도구 (8)

🟢 읽기 전용🟡 쓰기🔴 삭제⚪ 알 수 없음
🟢list_projects(limit, cursor)

Use this when someone asks which Wapiworld projects they have, or a project's id is needed. Returns each project's id, name and creation and edit times, 25 per page by default, with a cursor for more. Not for their WhatsApp numbers.

입력 스키마

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100,
      "description": "Projects per page, from 1 to 100; defaults to 25"
    },
    "cursor": {
      "type": "string",
      "maxLength": 4096,
      "description": "The page.nextCursor of the previous page; absent for the first page"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

출력 스키마

{
  "type": "object",
  "properties": {
    "projects": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "pattern": "^[0-9a-f]{24}$"
          },
          "name": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 200
              },
              {
                "type": "null"
              }
            ]
          },
          "creationTime": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 32
              },
              {
                "type": "null"
              }
            ]
          },
          "lastEditTime": {
            "$ref": "#/properties/projects/items/properties/creationTime"
          }
        },
        "required": [
          "id",
          "name",
          "creationTime",
          "lastEditTime"
        ],
        "additionalProperties": false
      },
      "maxItems": 100,
      "description": "Projects the session can reach; an API-key session sees only its own project. Internal organization ids and project configuration are omitted."
    },
    "page": {
      "type": "object",
      "properties": {
        "count": {
          "type": "integer",
          "minimum": 0
        },
        "total": {
          "type": "integer",
          "minimum": 0
        },
        "hasMore": {
          "type": "boolean"
        },
        "nextCursor": {
          "anyOf": [
            {
              "type": "string",
              "maxLength": 4096
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "count",
        "total",
        "hasMore",
        "nextCursor"
      ],
      "additionalProperties": false,
      "description": "Pass nextCursor as cursor, with the same filters, for the next page; null on the last page"
    }
  },
  "required": [
    "projects",
    "page"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢list_instances(projectId, limit, cursor)

Use this when someone asks which WhatsApp numbers they have connected to Wapiworld, or which ones are offline. Returns each instance's id, name, WhatsApp account name, phone number, connection status and health, 25 per page by default, optionally for one project (no QR codes, secrets or API keys). Not for sending a message.

입력 스키마

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128,
      "description": "Only this project"
    },
    "limit": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100,
      "description": "Instances per page, from 1 to 100; defaults to 25"
    },
    "cursor": {
      "type": "string",
      "maxLength": 4096,
      "description": "The page.nextCursor of the previous page with the same projectId; absent for the first page"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

출력 스키마

{
  "type": "object",
  "properties": {
    "instances": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "pattern": "^[0-9a-f]{24}$"
          },
          "name": {
            "type": "string",
            "maxLength": 200
          },
          "accountName": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 200
              },
              {
                "type": "null"
              }
            ]
          },
          "status": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "starting",
                  "qrcode",
                  "ready",
                  "logged_out",
                  "not_connected",
                  "disconnected",
                  "offline",
                  "STARTING",
                  "QRCODE",
                  "READY"
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "health": {
            "type": "string",
            "enum": [
              "ready",
              "pairing",
              "starting",
              "offline",
              "unknown"
            ]
          },
          "phone": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 32
              },
              {
                "type": "null"
              }
            ]
          },
          "projectId": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^[0-9a-f]{24}$"
              },
              {
                "type": "null"
              }
            ]
          },
          "creationTime": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 32
              },
              {
                "type": "null"
              }
            ]
          },
          "lastEditTime": {
            "$ref": "#/properties/instances/items/properties/creationTime"
          }
        },
        "required": [
          "id",
          "name",
          "accountName",
          "status",
          "health",
          "phone",
          "projectId",
          "creationTime",
          "lastEditTime"
        ],
        "additionalProperties": false
      },
      "maxItems": 100,
      "description": "Connected WhatsApp instances. health is ready, pairing, starting, offline or unknown. QR pairing codes, instance secrets, API keys, proxy data and arbitrary stored fields are never returned."
    },
    "page": {
      "type": "object",
      "properties": {
        "count": {
          "type": "integer",
          "minimum": 0
        },
        "hasMore": {
          "type": "boolean"
        },
        "nextCursor": {
          "anyOf": [
            {
              "type": "string",
              "maxLength": 4096
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "count",
        "hasMore",
        "nextCursor"
      ],
      "additionalProperties": false,
      "description": "Pass nextCursor as cursor, with the same filters, for the next page; null on the last page"
    }
  },
  "required": [
    "instances",
    "page"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢get_instance(instanceId)

Use this when someone asks about one connected WhatsApp number, such as its phone number, account name or connection health. Returns the instance's name, account name, phone number, project, status and health, or not-found. Not for message history, which this connector does not read.

입력 스키마

{
  "type": "object",
  "properties": {
    "instanceId": {
      "type": "string",
      "pattern": "^[0-9a-f]{24}$",
      "description": "Instance id: 24 lowercase hexadecimal characters"
    }
  },
  "required": [
    "instanceId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

출력 스키마

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "found",
        "not-found"
      ]
    },
    "instance": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "pattern": "^[0-9a-f]{24}$"
            },
            "name": {
              "type": "string",
              "maxLength": 200
            },
            "accountName": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 200
                },
                {
                  "type": "null"
                }
              ]
            },
            "status": {
              "anyOf": [
                {
                  "type": "string",
                  "enum": [
                    "starting",
                    "qrcode",
                    "ready",
                    "logged_out",
                    "not_connected",
                    "disconnected",
                    "offline",
                    "STARTING",
                    "QRCODE",
                    "READY"
                  ]
                },
                {
                  "type": "null"
                }
              ]
            },
            "health": {
              "type": "string",
              "enum": [
                "ready",
                "pairing",
                "starting",
                "offline",
                "unknown"
              ]
            },
            "phone": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 32
                },
                {
                  "type": "null"
                }
              ]
            },
            "projectId": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^[0-9a-f]{24}$"
                },
                {
                  "type": "null"
                }
              ]
            },
            "creationTime": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 32
                },
                {
                  "type": "null"
                }
              ]
            },
            "lastEditTime": {
              "$ref": "#/properties/instance/anyOf/0/properties/creationTime"
            }
          },
          "required": [
            "id",
            "name",
            "accountName",
            "status",
            "health",
            "phone",
            "projectId",
            "creationTime",
            "lastEditTime"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ],
      "description": "Null when not found. QR pairing codes, instance secrets, API keys, proxy addresses, organization ids and arbitrary stored metadata are never returned."
    }
  },
  "required": [
    "status",
    "instance"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢get_instance_status(instanceId)

Use this when someone asks whether a WhatsApp number is connected, waiting for QR pairing, starting or offline. Returns the instance's name, raw status and a health value: ready, pairing, starting, offline or unknown (no QR codes or credentials). Not for whether a sent message was delivered.

입력 스키마

{
  "type": "object",
  "properties": {
    "instanceId": {
      "type": "string",
      "pattern": "^[0-9a-f]{24}$",
      "description": "Instance id: 24 lowercase hexadecimal characters"
    }
  },
  "required": [
    "instanceId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

출력 스키마

{
  "type": "object",
  "properties": {
    "found": {
      "type": "boolean"
    },
    "instanceId": {
      "type": "string",
      "pattern": "^[0-9a-f]{24}$"
    },
    "name": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 200
        },
        {
          "type": "null"
        }
      ]
    },
    "status": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "starting",
            "qrcode",
            "ready",
            "logged_out",
            "not_connected",
            "disconnected",
            "offline",
            "STARTING",
            "QRCODE",
            "READY"
          ]
        },
        {
          "type": "null"
        }
      ]
    },
    "health": {
      "type": "string",
      "enum": [
        "ready",
        "pairing",
        "starting",
        "offline",
        "unknown"
      ],
      "description": "ready: connected; pairing: waiting for a QR scan; starting: connecting; offline: logged out or disconnected; unknown: unrecognized state"
    }
  },
  "required": [
    "found",
    "instanceId",
    "name",
    "status",
    "health"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢get_message_recording_policy(instanceId)

Use this when someone asks whether Wapiworld stores the text of WhatsApp messages for a number, or how long it keeps them. Returns whether recording is on for the instance, whether the default, project or instance decided it, any lock, and the project's retention in days. Not for reading recorded messages.

입력 스키마

{
  "type": "object",
  "properties": {
    "instanceId": {
      "type": "string",
      "pattern": "^[0-9a-f]{24}$",
      "description": "Instance id: 24 lowercase hexadecimal characters"
    }
  },
  "required": [
    "instanceId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

출력 스키마

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "found",
        "instance-not-found",
        "project-not-found"
      ]
    },
    "policy": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "instanceId": {
              "type": "string",
              "pattern": "^[0-9a-f]{24}$"
            },
            "projectId": {
              "type": "string",
              "pattern": "^[0-9a-f]{24}$"
            },
            "enabled": {
              "type": "boolean"
            },
            "decidedBy": {
              "type": "string",
              "enum": [
                "default",
                "project",
                "instance"
              ]
            },
            "lockedBy": {
              "anyOf": [
                {
                  "type": "string",
                  "enum": [
                    "project",
                    "instance"
                  ]
                },
                {
                  "type": "null"
                }
              ]
            },
            "retentionDays": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 365
            },
            "chatOverridesExcluded": {
              "type": "boolean",
              "const": true
            }
          },
          "required": [
            "instanceId",
            "projectId",
            "enabled",
            "decidedBy",
            "lockedBy",
            "retentionDays",
            "chatOverridesExcluded"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ],
      "description": "Instance default only; chat-level exceptions are excluded. Message bodies, previews, sender names, contact identifiers, chat override keys and WhatsApp message ids are never read."
    }
  },
  "required": [
    "status",
    "policy"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢list_webhook_subscriptions(projectId, limit, cursor)

Use this when someone asks whether their Wapiworld webhooks are working, failing or were switched off. Returns each subscription's endpoint scheme and host, events, active state, consecutive failures and an auto-disabled flag after 20 failures, 25 per page by default. Works only with an operator OAuth session, not an API key. Not for changing a webhook.

입력 스키마

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128,
      "description": "Only this project"
    },
    "limit": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100,
      "description": "Webhook subscriptions per page, from 1 to 100; defaults to 25"
    },
    "cursor": {
      "type": "string",
      "maxLength": 4096,
      "description": "The page.nextCursor of the previous page with the same projectId; absent for the first page"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

출력 스키마

{
  "type": "object",
  "properties": {
    "webhookSubscriptions": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "pattern": "^[0-9a-f]{24}$"
          },
          "projectId": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^[0-9a-f]{24}$"
              },
              {
                "type": "null"
              }
            ]
          },
          "endpointHost": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 300
              },
              {
                "type": "null"
              }
            ]
          },
          "events": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 64
            },
            "maxItems": 20
          },
          "active": {
            "type": "boolean"
          },
          "consecutiveFailures": {
            "type": "integer",
            "minimum": 0
          },
          "autoDisabled": {
            "type": "boolean"
          },
          "lastDeliveryTime": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 32
              },
              {
                "type": "null"
              }
            ]
          },
          "creationTime": {
            "$ref": "#/properties/webhookSubscriptions/items/properties/lastDeliveryTime"
          }
        },
        "required": [
          "id",
          "projectId",
          "endpointHost",
          "events",
          "active",
          "consecutiveFailures",
          "autoDisabled",
          "lastDeliveryTime",
          "creationTime"
        ],
        "additionalProperties": false
      },
      "maxItems": 100,
      "description": "Delivery health per subscription; autoDisabled marks an endpoint switched off after 20 consecutive failures. The signing secret, delivery paths, queries and fragments are never returned: hook paths often embed a credential."
    },
    "page": {
      "type": "object",
      "properties": {
        "count": {
          "type": "integer",
          "minimum": 0
        },
        "hasMore": {
          "type": "boolean"
        },
        "nextCursor": {
          "anyOf": [
            {
              "type": "string",
              "maxLength": 4096
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "count",
        "hasMore",
        "nextCursor"
      ],
      "additionalProperties": false,
      "description": "Pass nextCursor as cursor, with the same filters, for the next page; null on the last page"
    }
  },
  "required": [
    "webhookSubscriptions",
    "page"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🔴send_message(instanceId, chatId, content)

Use this when someone asks to send a WhatsApp message from one of their Wapiworld numbers. Returns only that Wapiworld accepted the send, not proof of delivery. The message goes out immediately, each call sends another copy, and recording settings may store its text. Not for broadcasts or bulk sends.

입력 스키마

{
  "type": "object",
  "properties": {
    "instanceId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128,
      "description": "Sender instance id, shown to the user before confirmation"
    },
    "chatId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128,
      "description": "Exact recipient phone number in international format (for example +1234567890) or exact WhatsApp chat id. Show it to the user before requesting confirmation."
    },
    "content": {
      "type": "string",
      "minLength": 1,
      "maxLength": 4096,
      "description": "Exact text message to send, maximum 4096 characters. Show the complete text before confirmation. Do not send credentials, PHI, PCI cardholder data, government identifiers, or other restricted data."
    }
  },
  "required": [
    "instanceId",
    "chatId",
    "content"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

출력 스키마

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "const": "accepted",
      "description": "Wapiworld accepted the send for transport; not proof of delivery or reading"
    }
  },
  "required": [
    "status"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢show_project_overview(projectId)

Use this when someone wants a quick overview or dashboard of one Wapiworld project's WhatsApp numbers. Returns an overview card with the project name, how many instances are ready, pairing, starting, offline or unknown (counting up to 100), and up to 20 instances with phone and status. Not for sending a message.

입력 스키마

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128,
      "description": "Project id"
    }
  },
  "required": [
    "projectId"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

출력 스키마

{
  "type": "object",
  "properties": {
    "project": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "pattern": "^[0-9a-f]{24}$"
            },
            "name": {
              "type": "string",
              "maxLength": 200
            }
          },
          "required": [
            "id",
            "name"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "instanceCount": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "instanceCountIsLowerBound": {
      "type": "boolean"
    },
    "statusCounts": {
      "type": "object",
      "properties": {
        "ready": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        "pairing": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        "starting": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        "offline": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        "unknown": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        }
      },
      "required": [
        "ready",
        "pairing",
        "starting",
        "offline",
        "unknown"
      ],
      "additionalProperties": false
    },
    "statusCountsAreLowerBounds": {
      "type": "boolean"
    },
    "instances": {
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "pattern": "^[0-9a-f]{24}$"
          },
          "name": {
            "type": "string",
            "maxLength": 200
          },
          "status": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "starting",
                  "qrcode",
                  "ready",
                  "logged_out",
                  "not_connected",
                  "disconnected",
                  "offline",
                  "STARTING",
                  "QRCODE",
                  "READY"
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "health": {
            "type": "string",
            "enum": [
              "ready",
              "pairing",
              "starting",
              "offline",
              "unknown"
            ]
          },
          "phone": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 32
              },
              {
                "type": "null"
              }
            ]
          },
          "lastEditTime": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 32
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "id",
          "name",
          "status",
          "health",
          "phone",
          "lastEditTime"
        ],
        "additionalProperties": false
      },
      "description": "Up to 20 instances. QR pairing codes, instance credentials, API keys, proxy data and arbitrary stored fields are excluded."
    }
  },
  "required": [
    "project",
    "instanceCount",
    "instanceCountIsLowerBound",
    "statusCounts",
    "statusCountsAreLowerBounds",
    "instances"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

커뮤니티

이 서버 평가하기

증거

최근 관측

검증됨버전이 기록되지 않음도구 8개
검증됨버전이 기록되지 않음도구 8개
검증됨버전이 기록되지 않음도구 8개
검증됨버전이 기록되지 않음도구 8개
검증됨버전이 기록되지 않음도구 8개
검증됨버전이 기록되지 않음도구 8개
검증됨버전이 기록되지 않음도구 8개