Documentation

Learn how to connect your AI client, manage ad campaigns, and get the most out of Digital Face.

Quick Start

Get running in four steps.

Sign up

Create a free account at digitalface.app

Connect your AI client

Add the MCP server URL to Claude Code, ChatGPT, Claude Web, or Cursor

Connect an ad platform

Link Google Ads or Meta Ads via OAuth from the dashboard

Start asking

Ask your AI to check connections, research keywords, or analyze campaigns

Read the full Quick Start guide →

AI Client Setup

Configuration snippets for each supported client. The MCP endpoint is the same for all clients.

MCP Endpoint: https://digitalface.app/api/mcp

Claude Code

Run this command in your terminal:

Terminal

claude mcp add --transport http digital-face https://digitalface.app/api/mcp

ChatGPT

Go to Settings > Connectors > Add custom connector, then paste the URL:

Connector URL

https://digitalface.app/api/mcp

Claude Web

Go to Customize > Connectors, then paste the URL:

Connector URL

https://digitalface.app/api/mcp

Cursor

Add the following to your MCP configuration JSON:

MCP Config

{
  "mcpServers": {
    "digital-face": {
      "url": "https://digitalface.app/api/mcp"
    }
  }
}

Ad Platform Guides

How to connect and use each advertising platform.

Google Ads

Connect via OAuth from the dashboard
Keyword research with real CPC data
Create Search campaigns (always PAUSED)
Performance analysis and budget management
Search term reports and negative keywords

Meta Ads

Coming Soon

Connect via Facebook OAuth
Campaign and ad set performance
Creative fatigue detection
Budget management with guardrails
Audience and placement insights

Tool Reference

Digital Face exposes 15 tools via MCP. Your AI client calls these automatically based on your requests.

Tool	Type	Platform	Description
`check_connections`	Read	Cross	Verify which ad platforms are connected
`google_keyword_research`	Read	Google	Research keywords with CPC, volume, and competition data
`google_create_campaign`	Write	Google	Create a Google Search campaign (always PAUSED)
`google_get_campaigns`	Read	Google	List campaigns with performance metrics
`google_get_campaign_details`	Read	Google	Detailed metrics for a specific campaign
`google_update_budget`	Write	Google	Adjust campaign budget (max 50% change)
`google_update_campaign_status`	Write	Google	Pause, enable, or remove a campaign
`google_get_ad_groups`	Read	Google	List ad groups within a campaign
`google_get_search_terms`	Read	Google	Search term report with performance data
`google_add_negative_keywords`	Write	Google	Add negative keywords to filter bad traffic
`meta_get_campaigns`	Read	Meta	List Meta ad campaigns with metrics
`meta_get_adsets`	Read	Meta	List ad sets within a campaign
`meta_get_ads`	Read	Meta	List individual ads with creative performance
`meta_get_creative_fatigue`	Read	Meta	Detect creatives with rising frequency and declining CTR
`meta_update_budget`	Write	Meta	Adjust Meta campaign or ad set budget

View full tool reference with parameters →

API Keys

API keys allow programmatic and headless access to the MCP endpoint without browser-based authentication.

Creating an API Key

Go to Dashboard > API Keys
Click "Create API Key" and give it a descriptive name
Copy the key immediately -- it will only be shown once
Pass the key as a Bearer token in the Authorization header

HTTP Header

Authorization: Bearer df_your_api_key_here

Security

How we keep your data and ad accounts safe.

OAuth 2.1 + PKCE

Industry-standard auth flow. No passwords stored.

AES-256-GCM Encryption

All tokens encrypted at rest with rotating keys.

Safety Guardrails

Campaigns created PAUSED. Budget changes capped at 50%.

Minimal Data Storage

We store connection tokens only. Your ad data stays with Google/Meta.

Read the full security documentation →

FAQ

Is Digital Face free?

Yes. The free plan includes 15 tool calls per month. Paid plans start at $39/mo for 150 calls.

Which AI clients are supported?

Any MCP-compatible client works. We have tested with Claude Code, ChatGPT, Claude Web, and Cursor.

Will Digital Face spend money on my behalf?

No. All new campaigns are created in PAUSED state. Budget changes are capped at 50% per adjustment. You always confirm before anything goes live.

How do I revoke access?

Go to Dashboard > Ad Accounts and click Disconnect. You can also revoke access from your Google or Meta account settings directly.

Is my data secure?

Yes. We use OAuth 2.1 with PKCE, encrypt all tokens with AES-256-GCM, and never store your ad platform passwords. See our Security page for details.

Can I use Digital Face with multiple ad accounts?

Yes. You can connect multiple Google Ads and Meta Ads accounts. The AI will ask which account to use when you have more than one.