facebook-mcp
mcpkey · packageFacebook Pages MCP server for the Meta Graph API — publishing, insights, moderation, messaging
run it
on your own machines, one way per deploy method#!/usr/bin/env bash # facebook (io.github.IvanBBaev/facebook-mcp), recipe baremetal (generated). # Generated by Hub for toolset "my-agent"; started by mcp-my-agent-facebook.service. set -euo pipefail export HOST=127.0.0.1 PORT=8101 exec npx -y supergateway@4 --stdio 'npx -y @ivanbaev/[email protected]' --outputTransport streamableHttp --stateful --host 127.0.0.1 --port 8101 --streamableHttpPath /mcp --healthEndpoint /healthz [Unit] Description=MCP server facebook (toolset my-agent), generated by Hub After=network-online.target Wants=network-online.target [Service] Type=simple User=mcp Group=mcp EnvironmentFile=/etc/mcp/my-agent.env Environment=HOME=/var/lib/mcp/facebook WorkingDirectory=/var/lib/mcp/facebook ExecStart=/opt/mcp/my-agent/bin/facebook.sh Restart=on-failure RestartSec=5 NoNewPrivileges=true ProtectSystem=strict ProtectHome=true PrivateTmp=true ReadWritePaths=/var/lib/mcp/facebook [Install] WantedBy=multi-user.target
docker run --rm -p 127.0.0.1:8101:8000 -e FB_SYSTEM_TOKEN -e FB_ACCESS_TOKEN -e FB_PAGE_TOKEN -e FB_APP_ID -e FB_APP_SECRET -e FB_PAGE_ID -e FB_API_VERSION -e FB_REQUEST_TIMEOUT_MS -e FB_HOST_CONCURRENCY -e FB_MAX_RESULT_CHARS -e FB_WRITE_MODE -e FB_CONFIRM_TOKEN -e FB_MEDIA_DIR -e FB_JOURNAL_PATH -e FB_TOOL_PACKAGES -e FB_PACKAGES_DENY -e FB_PACKAGES_READONLY -e FB_TRANSPORT -e FB_HTTP_TOKEN -e FB_HTTP_PORT -e FB_AD_ACCOUNT_ID -e FB_ADS_BUDGET_CEILING -e FB_LOG_LEVEL node:22-alpine sh -c 'npx -y supergateway@4 --stdio '"'"'npx -y @ivanbaev/[email protected]'"'"' --outputTransport streamableHttp --stateful --host 0.0.0.0 --port 8000 --streamableHttpPath /mcp --healthEndpoint /healthz'
# Generated by Hub for toolset "my-agent" (2026-10-18T00:41:56+00:00).
# Each package server runs behind a stdio->HTTP bridge and listens on localhost only.
# cp .env.example .env # fill the ${VAR}s
# docker compose up -d && bash smoke.sh
# Remote servers are not here: clients reach them directly (see clients/).
name: mcp-my-agent
services:
facebook:
image: node:22-alpine
command:
- sh
- -c
- npx -y supergateway@4 --stdio 'npx -y @ivanbaev/[email protected]' --outputTransport streamableHttp
--stateful --host 0.0.0.0 --port 8000 --streamableHttpPath /mcp --healthEndpoint /healthz
ports:
- 127.0.0.1:8101:8000
volumes:
- npm-cache:/root/.npm
healthcheck:
test:
- CMD-SHELL
- wget -qO- http://127.0.0.1:8000/healthz || exit 1
interval: 30s
timeout: 5s
retries: 5
start_period: 2m
restart: unless-stopped
environment:
FB_SYSTEM_TOKEN: ${FB_SYSTEM_TOKEN}
FB_ACCESS_TOKEN: ${FB_ACCESS_TOKEN}
FB_PAGE_TOKEN: ${FB_PAGE_TOKEN}
FB_APP_ID: ${FB_APP_ID}
FB_APP_SECRET: ${FB_APP_SECRET}
FB_PAGE_ID: ${FB_PAGE_ID}
FB_API_VERSION: ${FB_API_VERSION}
FB_REQUEST_TIMEOUT_MS: ${FB_REQUEST_TIMEOUT_MS}
FB_HOST_CONCURRENCY: ${FB_HOST_CONCURRENCY}
FB_MAX_RESULT_CHARS: ${FB_MAX_RESULT_CHARS}
FB_WRITE_MODE: ${FB_WRITE_MODE}
FB_CONFIRM_TOKEN: ${FB_CONFIRM_TOKEN}
FB_MEDIA_DIR: ${FB_MEDIA_DIR}
FB_JOURNAL_PATH: ${FB_JOURNAL_PATH}
FB_TOOL_PACKAGES: ${FB_TOOL_PACKAGES}
FB_PACKAGES_DENY: ${FB_PACKAGES_DENY}
FB_PACKAGES_READONLY: ${FB_PACKAGES_READONLY}
FB_TRANSPORT: ${FB_TRANSPORT}
FB_HTTP_TOKEN: ${FB_HTTP_TOKEN}
FB_HTTP_PORT: ${FB_HTTP_PORT}
FB_AD_ACCOUNT_ID: ${FB_AD_ACCOUNT_ID}
FB_ADS_BUDGET_CEILING: ${FB_ADS_BUDGET_CEILING}
FB_LOG_LEVEL: ${FB_LOG_LEVEL}
volumes:
npm-cache: {}
uv-cache: {}
# Generated by Hub for toolset "my-agent" (2026-10-18T00:41:56+00:00).
# kubectl create namespace mcp
# kubectl -n mcp create secret generic mcp-credentials --from-env-file=.env
# kubectl apply -f kubernetes.yaml
# Services are cluster-internal: <name>.mcp.svc.cluster.local:8000/mcp. Put an ingress
# with auth in front before exposing any of them.
apiVersion: v1
kind: Namespace
metadata:
name: mcp
---
apiVersion: apps/v1
kind: Deployment
metadata:
name: facebook
namespace: mcp
labels: &id001
app: facebook
spec:
replicas: 1
selector:
matchLabels: *id001
template:
metadata:
labels: *id001
spec:
containers:
- name: facebook
image: node:22-alpine
ports:
- containerPort: 8000
name: http
env:
- name: FB_SYSTEM_TOKEN
valueFrom:
secretKeyRef:
name: mcp-credentials
key: FB_SYSTEM_TOKEN
- name: FB_ACCESS_TOKEN
valueFrom:
secretKeyRef:
name: mcp-credentials
key: FB_ACCESS_TOKEN
- name: FB_PAGE_TOKEN
valueFrom:
secretKeyRef:
name: mcp-credentials
key: FB_PAGE_TOKEN
- name: FB_APP_ID
valueFrom:
secretKeyRef:
name: mcp-credentials
key: FB_APP_ID
- name: FB_APP_SECRET
valueFrom:
secretKeyRef:
name: mcp-credentials
key: FB_APP_SECRET
- name: FB_PAGE_ID
valueFrom:
secretKeyRef:
name: mcp-credentials
key: FB_PAGE_ID
- name: FB_API_VERSION
valueFrom:
secretKeyRef:
name: mcp-credentials
key: FB_API_VERSION
- name: FB_REQUEST_TIMEOUT_MS
valueFrom:
secretKeyRef:
name: mcp-credentials
key: FB_REQUEST_TIMEOUT_MS
- name: FB_HOST_CONCURRENCY
valueFrom:
secretKeyRef:
name: mcp-credentials
key: FB_HOST_CONCURRENCY
- name: FB_MAX_RESULT_CHARS
valueFrom:
secretKeyRef:
name: mcp-credentials
key: FB_MAX_RESULT_CHARS
- name: FB_WRITE_MODE
valueFrom:
secretKeyRef:
name: mcp-credentials
key: FB_WRITE_MODE
- name: FB_CONFIRM_TOKEN
valueFrom:
secretKeyRef:
name: mcp-credentials
key: FB_CONFIRM_TOKEN
- name: FB_MEDIA_DIR
valueFrom:
secretKeyRef:
name: mcp-credentials
key: FB_MEDIA_DIR
- name: FB_JOURNAL_PATH
valueFrom:
secretKeyRef:
name: mcp-credentials
key: FB_JOURNAL_PATH
- name: FB_TOOL_PACKAGES
valueFrom:
secretKeyRef:
name: mcp-credentials
key: FB_TOOL_PACKAGES
- name: FB_PACKAGES_DENY
valueFrom:
secretKeyRef:
name: mcp-credentials
key: FB_PACKAGES_DENY
- name: FB_PACKAGES_READONLY
valueFrom:
secretKeyRef:
name: mcp-credentials
key: FB_PACKAGES_READONLY
- name: FB_TRANSPORT
valueFrom:
secretKeyRef:
name: mcp-credentials
key: FB_TRANSPORT
- name: FB_HTTP_TOKEN
valueFrom:
secretKeyRef:
name: mcp-credentials
key: FB_HTTP_TOKEN
- name: FB_HTTP_PORT
valueFrom:
secretKeyRef:
name: mcp-credentials
key: FB_HTTP_PORT
- name: FB_AD_ACCOUNT_ID
valueFrom:
secretKeyRef:
name: mcp-credentials
key: FB_AD_ACCOUNT_ID
- name: FB_ADS_BUDGET_CEILING
valueFrom:
secretKeyRef:
name: mcp-credentials
key: FB_ADS_BUDGET_CEILING
- name: FB_LOG_LEVEL
valueFrom:
secretKeyRef:
name: mcp-credentials
key: FB_LOG_LEVEL
command:
- sh
- -c
- npx -y supergateway@4 --stdio 'npx -y @ivanbaev/[email protected]' --outputTransport streamableHttp
--stateful --host 0.0.0.0 --port 8000 --streamableHttpPath /mcp --healthEndpoint /healthz
readinessProbe:
httpGet:
path: /healthz
port: http
initialDelaySeconds: 10
---
apiVersion: v1
kind: Service
metadata:
name: facebook
namespace: mcp
spec:
selector:
app: facebook
ports:
- port: 8000
targetPort: http
name: http
# Generated by Hub for toolset "my-agent" (2026-10-18T00:41:56+00:00).
# Credentials come from the Secret 'mcp-credentials' (kubectl create secret generic ... --from-env-file=.env).
# Each server under `servers` is one Deployment + Service; the keys after it configure
# upstream charts a worker verified.
servers:
facebook:
enabled: true
replicas: 1
port: 8000
path: /mcp
container:
name: facebook
image: node:22-alpine
ports:
- containerPort: 8000
name: http
env:
- name: FB_SYSTEM_TOKEN
valueFrom:
secretKeyRef:
name: mcp-credentials
key: FB_SYSTEM_TOKEN
- name: FB_ACCESS_TOKEN
valueFrom:
secretKeyRef:
name: mcp-credentials
key: FB_ACCESS_TOKEN
- name: FB_PAGE_TOKEN
valueFrom:
secretKeyRef:
name: mcp-credentials
key: FB_PAGE_TOKEN
- name: FB_APP_ID
valueFrom:
secretKeyRef:
name: mcp-credentials
key: FB_APP_ID
- name: FB_APP_SECRET
valueFrom:
secretKeyRef:
name: mcp-credentials
key: FB_APP_SECRET
- name: FB_PAGE_ID
valueFrom:
secretKeyRef:
name: mcp-credentials
key: FB_PAGE_ID
- name: FB_API_VERSION
valueFrom:
secretKeyRef:
name: mcp-credentials
key: FB_API_VERSION
- name: FB_REQUEST_TIMEOUT_MS
valueFrom:
secretKeyRef:
name: mcp-credentials
key: FB_REQUEST_TIMEOUT_MS
- name: FB_HOST_CONCURRENCY
valueFrom:
secretKeyRef:
name: mcp-credentials
key: FB_HOST_CONCURRENCY
- name: FB_MAX_RESULT_CHARS
valueFrom:
secretKeyRef:
name: mcp-credentials
key: FB_MAX_RESULT_CHARS
- name: FB_WRITE_MODE
valueFrom:
secretKeyRef:
name: mcp-credentials
key: FB_WRITE_MODE
- name: FB_CONFIRM_TOKEN
valueFrom:
secretKeyRef:
name: mcp-credentials
key: FB_CONFIRM_TOKEN
- name: FB_MEDIA_DIR
valueFrom:
secretKeyRef:
name: mcp-credentials
key: FB_MEDIA_DIR
- name: FB_JOURNAL_PATH
valueFrom:
secretKeyRef:
name: mcp-credentials
key: FB_JOURNAL_PATH
- name: FB_TOOL_PACKAGES
valueFrom:
secretKeyRef:
name: mcp-credentials
key: FB_TOOL_PACKAGES
- name: FB_PACKAGES_DENY
valueFrom:
secretKeyRef:
name: mcp-credentials
key: FB_PACKAGES_DENY
- name: FB_PACKAGES_READONLY
valueFrom:
secretKeyRef:
name: mcp-credentials
key: FB_PACKAGES_READONLY
- name: FB_TRANSPORT
valueFrom:
secretKeyRef:
name: mcp-credentials
key: FB_TRANSPORT
- name: FB_HTTP_TOKEN
valueFrom:
secretKeyRef:
name: mcp-credentials
key: FB_HTTP_TOKEN
- name: FB_HTTP_PORT
valueFrom:
secretKeyRef:
name: mcp-credentials
key: FB_HTTP_PORT
- name: FB_AD_ACCOUNT_ID
valueFrom:
secretKeyRef:
name: mcp-credentials
key: FB_AD_ACCOUNT_ID
- name: FB_ADS_BUDGET_CEILING
valueFrom:
secretKeyRef:
name: mcp-credentials
key: FB_ADS_BUDGET_CEILING
- name: FB_LOG_LEVEL
valueFrom:
secretKeyRef:
name: mcp-credentials
key: FB_LOG_LEVEL
command:
- sh
- -c
- npx -y supergateway@4 --stdio 'npx -y @ivanbaev/[email protected]' --outputTransport streamableHttp
--stateful --host 0.0.0.0 --port 8000 --streamableHttpPath /mcp --healthEndpoint /healthz
readinessProbe:
httpGet:
path: /healthz
port: http
initialDelaySeconds: 10
# helm install my-agent helm/my-agent -n mcp
in the cloud
one click: the provider's deploy form opens filled in, in your own account- koyeb
-
The form opens with CHANGE_ME for each value you supply: FB_SYSTEM_TOKEN, FB_ACCESS_TOKEN, FB_PAGE_TOKEN, FB_APP_ID, FB_APP_SECRET, FB_PAGE_ID, FB_API_VERSION, FB_REQUEST_TIMEOUT_MS, FB_HOST_CONCURRENCY, FB_MAX_RESULT_CHARS, FB_WRITE_MODE, FB_CONFIRM_TOKEN, FB_MEDIA_DIR, FB_JOURNAL_PATH, FB_TOOL_PACKAGES, FB_PACKAGES_DENY, FB_PACKAGES_READONLY, FB_TRANSPORT, FB_HTTP_TOKEN, FB_HTTP_PORT, FB_AD_ACCOUNT_ID, FB_ADS_BUDGET_CEILING, FB_LOG_LEVEL. Fill them in before you deploy.
Clients connect to the service's https://…koyeb.app address plus /mcp.
- azure
-
A Container Apps environment with one app per server, each with HTTPS ingress and one replica. The portal asks for each value you supply as a secure parameter; the deployment's outputs list the endpoints.
connect to it
copy what your client needsnpx -y @ivanbaev/[email protected] # env: FB_SYSTEM_TOKEN, FB_ACCESS_TOKEN, FB_PAGE_TOKEN, FB_APP_ID, FB_APP_SECRET, FB_PAGE_ID, FB_API_VERSION, FB_REQUEST_TIMEOUT_MS, FB_HOST_CONCURRENCY, FB_MAX_RESULT_CHARS, FB_WRITE_MODE, FB_CONFIRM_TOKEN, FB_MEDIA_DIR, FB_JOURNAL_PATH, FB_TOOL_PACKAGES, FB_PACKAGES_DENY, FB_PACKAGES_READONLY, FB_TRANSPORT, FB_HTTP_TOKEN, FB_HTTP_PORT, FB_AD_ACCOUNT_ID, FB_ADS_BUDGET_CEILING, FB_LOG_LEVEL
{
"mcpServers": {
"facebook": {
"command": "npx",
"args": [
"-y",
"@ivanbaev/[email protected]"
],
"env": {
"FB_SYSTEM_TOKEN": "${FB_SYSTEM_TOKEN}",
"FB_ACCESS_TOKEN": "${FB_ACCESS_TOKEN}",
"FB_PAGE_TOKEN": "${FB_PAGE_TOKEN}",
"FB_APP_ID": "${FB_APP_ID}",
"FB_APP_SECRET": "${FB_APP_SECRET}",
"FB_PAGE_ID": "${FB_PAGE_ID}",
"FB_API_VERSION": "${FB_API_VERSION}",
"FB_REQUEST_TIMEOUT_MS": "${FB_REQUEST_TIMEOUT_MS}",
"FB_HOST_CONCURRENCY": "${FB_HOST_CONCURRENCY}",
"FB_MAX_RESULT_CHARS": "${FB_MAX_RESULT_CHARS}",
"FB_WRITE_MODE": "${FB_WRITE_MODE}",
"FB_CONFIRM_TOKEN": "${FB_CONFIRM_TOKEN}",
"FB_MEDIA_DIR": "${FB_MEDIA_DIR}",
"FB_JOURNAL_PATH": "${FB_JOURNAL_PATH}",
"FB_TOOL_PACKAGES": "${FB_TOOL_PACKAGES}",
"FB_PACKAGES_DENY": "${FB_PACKAGES_DENY}",
"FB_PACKAGES_READONLY": "${FB_PACKAGES_READONLY}",
"FB_TRANSPORT": "${FB_TRANSPORT}",
"FB_HTTP_TOKEN": "${FB_HTTP_TOKEN}",
"FB_HTTP_PORT": "${FB_HTTP_PORT}",
"FB_AD_ACCOUNT_ID": "${FB_AD_ACCOUNT_ID}",
"FB_ADS_BUDGET_CEILING": "${FB_ADS_BUDGET_CEILING}",
"FB_LOG_LEVEL": "${FB_LOG_LEVEL}"
}
}
}
}
#!/usr/bin/env bash
# Registers every server with Claude Code (run once; `claude mcp list` to check).
set -euo pipefail
set -a; [ -f .env ] && source .env; set +a
claude mcp add facebook -e "FB_SYSTEM_TOKEN=${FB_SYSTEM_TOKEN}" -e "FB_ACCESS_TOKEN=${FB_ACCESS_TOKEN}" -e "FB_PAGE_TOKEN=${FB_PAGE_TOKEN}" -e "FB_APP_ID=${FB_APP_ID}" -e "FB_APP_SECRET=${FB_APP_SECRET}" -e "FB_PAGE_ID=${FB_PAGE_ID}" -e "FB_API_VERSION=${FB_API_VERSION}" -e "FB_REQUEST_TIMEOUT_MS=${FB_REQUEST_TIMEOUT_MS}" -e "FB_HOST_CONCURRENCY=${FB_HOST_CONCURRENCY}" -e "FB_MAX_RESULT_CHARS=${FB_MAX_RESULT_CHARS}" -e "FB_WRITE_MODE=${FB_WRITE_MODE}" -e "FB_CONFIRM_TOKEN=${FB_CONFIRM_TOKEN}" -e "FB_MEDIA_DIR=${FB_MEDIA_DIR}" -e "FB_JOURNAL_PATH=${FB_JOURNAL_PATH}" -e "FB_TOOL_PACKAGES=${FB_TOOL_PACKAGES}" -e "FB_PACKAGES_DENY=${FB_PACKAGES_DENY}" -e "FB_PACKAGES_READONLY=${FB_PACKAGES_READONLY}" -e "FB_TRANSPORT=${FB_TRANSPORT}" -e "FB_HTTP_TOKEN=${FB_HTTP_TOKEN}" -e "FB_HTTP_PORT=${FB_HTTP_PORT}" -e "FB_AD_ACCOUNT_ID=${FB_AD_ACCOUNT_ID}" -e "FB_ADS_BUDGET_CEILING=${FB_ADS_BUDGET_CEILING}" -e "FB_LOG_LEVEL=${FB_LOG_LEVEL}" -- npx -y @ivanbaev/[email protected]
{
"mcpServers": {
"facebook": {
"command": "npx",
"args": [
"-y",
"@ivanbaev/[email protected]"
],
"env": {
"FB_SYSTEM_TOKEN": "${FB_SYSTEM_TOKEN}",
"FB_ACCESS_TOKEN": "${FB_ACCESS_TOKEN}",
"FB_PAGE_TOKEN": "${FB_PAGE_TOKEN}",
"FB_APP_ID": "${FB_APP_ID}",
"FB_APP_SECRET": "${FB_APP_SECRET}",
"FB_PAGE_ID": "${FB_PAGE_ID}",
"FB_API_VERSION": "${FB_API_VERSION}",
"FB_REQUEST_TIMEOUT_MS": "${FB_REQUEST_TIMEOUT_MS}",
"FB_HOST_CONCURRENCY": "${FB_HOST_CONCURRENCY}",
"FB_MAX_RESULT_CHARS": "${FB_MAX_RESULT_CHARS}",
"FB_WRITE_MODE": "${FB_WRITE_MODE}",
"FB_CONFIRM_TOKEN": "${FB_CONFIRM_TOKEN}",
"FB_MEDIA_DIR": "${FB_MEDIA_DIR}",
"FB_JOURNAL_PATH": "${FB_JOURNAL_PATH}",
"FB_TOOL_PACKAGES": "${FB_TOOL_PACKAGES}",
"FB_PACKAGES_DENY": "${FB_PACKAGES_DENY}",
"FB_PACKAGES_READONLY": "${FB_PACKAGES_READONLY}",
"FB_TRANSPORT": "${FB_TRANSPORT}",
"FB_HTTP_TOKEN": "${FB_HTTP_TOKEN}",
"FB_HTTP_PORT": "${FB_HTTP_PORT}",
"FB_AD_ACCOUNT_ID": "${FB_AD_ACCOUNT_ID}",
"FB_ADS_BUDGET_CEILING": "${FB_ADS_BUDGET_CEILING}",
"FB_LOG_LEVEL": "${FB_LOG_LEVEL}"
}
}
}
}
{
"servers": {
"facebook": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@ivanbaev/[email protected]"
],
"env": {
"FB_SYSTEM_TOKEN": "${FB_SYSTEM_TOKEN}",
"FB_ACCESS_TOKEN": "${FB_ACCESS_TOKEN}",
"FB_PAGE_TOKEN": "${FB_PAGE_TOKEN}",
"FB_APP_ID": "${FB_APP_ID}",
"FB_APP_SECRET": "${FB_APP_SECRET}",
"FB_PAGE_ID": "${FB_PAGE_ID}",
"FB_API_VERSION": "${FB_API_VERSION}",
"FB_REQUEST_TIMEOUT_MS": "${FB_REQUEST_TIMEOUT_MS}",
"FB_HOST_CONCURRENCY": "${FB_HOST_CONCURRENCY}",
"FB_MAX_RESULT_CHARS": "${FB_MAX_RESULT_CHARS}",
"FB_WRITE_MODE": "${FB_WRITE_MODE}",
"FB_CONFIRM_TOKEN": "${FB_CONFIRM_TOKEN}",
"FB_MEDIA_DIR": "${FB_MEDIA_DIR}",
"FB_JOURNAL_PATH": "${FB_JOURNAL_PATH}",
"FB_TOOL_PACKAGES": "${FB_TOOL_PACKAGES}",
"FB_PACKAGES_DENY": "${FB_PACKAGES_DENY}",
"FB_PACKAGES_READONLY": "${FB_PACKAGES_READONLY}",
"FB_TRANSPORT": "${FB_TRANSPORT}",
"FB_HTTP_TOKEN": "${FB_HTTP_TOKEN}",
"FB_HTTP_PORT": "${FB_HTTP_PORT}",
"FB_AD_ACCOUNT_ID": "${FB_AD_ACCOUNT_ID}",
"FB_ADS_BUDGET_CEILING": "${FB_ADS_BUDGET_CEILING}",
"FB_LOG_LEVEL": "${FB_LOG_LEVEL}"
}
}
}
}
name: my-agent target: local servers: - hub: io.github.IvanBBaev/facebook-mcp
- not probed yet: tools unpinned, ingest lists them