Your agent. Your research workspace.

Read your profile, current key permissions, and free trial status.

Returns: Profile: id, name, email, role, image; plan='free_trial', billingEnabled=false; key: id, scopes, expiresAt (Unix milliseconds).

Scope: account:read · MCP: trenzhub_get_account

No parameters.

curl --fail-with-body -X GET 'https://trenzhub.com/api/v1/me' \
  -H "Authorization: Bearer $TRENZHUB_API_KEY"

Update your display name across your account and active website sessions.

Returns: Updated profile: id, name, email, role, image.

Scope: account:write · MCP: trenzhub_update_account

curl --fail-with-body -X PATCH 'https://trenzhub.com/api/v1/me' \
  -H "Authorization: Bearer $TRENZHUB_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{"name":"Research workspace"}'

Upload a PNG, JPEG, or WebP avatar as base64 (maximum decoded size 45 KiB).

Returns: {image}: the stored image path, served under /images/.

Scope: account:write · MCP: trenzhub_set_avatar

curl --fail-with-body -X POST 'https://trenzhub.com/api/v1/me/avatar' \
  -H "Authorization: Bearer $TRENZHUB_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{"contentType":"image/png","base64":"VALUE"}'

Remove your profile avatar.

Returns: {image: null}.

Scope: account:write · MCP: trenzhub_delete_avatar

No parameters.

curl --fail-with-body -X DELETE 'https://trenzhub.com/api/v1/me/avatar' \
  -H "Authorization: Bearer $TRENZHUB_API_KEY"

List your active website login sessions. Session tokens are never returned.

Returns: Array of {id, createdAt, expiresAt, userAgent, ipAddress}; dates are ISO 8601 strings. Tokens are omitted.

Scope: account:read · MCP: trenzhub_list_sessions

No parameters.

curl --fail-with-body -X GET 'https://trenzhub.com/api/v1/me/sessions' \
  -H "Authorization: Bearer $TRENZHUB_API_KEY"

Sign out one of your website sessions by its ID. Does not revoke API keys.

Returns: {revoked: true, sessionId}.

Scope: account:security · MCP: trenzhub_revoke_session

curl --fail-with-body -X DELETE 'https://trenzhub.com/api/v1/me/sessions/YOUR_SESSION_ID' \
  -H "Authorization: Bearer $TRENZHUB_API_KEY"

Sign out all of your website login sessions. API keys continue to work.

Returns: {revoked: true}.

Scope: account:security · MCP: trenzhub_revoke_all_sessions

curl --fail-with-body -X POST 'https://trenzhub.com/api/v1/me/sessions/revoke-all' \
  -H "Authorization: Bearer $TRENZHUB_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{"confirm":"VALUE"}'

Change your email/password credential using your current password. Revokes website sessions and all other API keys.

Returns: {changed: true, websiteSessionsRevoked: true, otherApiKeysRevoked: true}. The calling key remains valid.

Scope: account:security · MCP: trenzhub_change_password

curl --fail-with-body -X POST 'https://trenzhub.com/api/v1/me/password' \
  -H "Authorization: Bearer $TRENZHUB_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{"currentPassword":"YOUR_CURRENT_PASSWORD","newPassword":"YOUR_NEW_PASSWORD"}'

List your linked login providers. Provider secrets and access tokens are never returned.

Returns: Array of {providerId, accountId, createdAt}. Provider tokens and credential hashes are omitted.

Scope: account:read · MCP: trenzhub_list_connections

No parameters.

curl --fail-with-body -X GET 'https://trenzhub.com/api/v1/me/connections' \
  -H "Authorization: Bearer $TRENZHUB_API_KEY"

Return the account-connections page where the user can complete provider consent in their signed-in browser.

Returns: {provider, requiresBrowserConsent: true, url, instruction}. Open url in the user's signed-in browser.

Scope: account:security · MCP: trenzhub_connect_account

curl --fail-with-body -X POST 'https://trenzhub.com/api/v1/me/connections' \
  -H "Authorization: Bearer $TRENZHUB_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{"provider":"google"}'

Unlink a Google or GitHub login provider. At least one working login method must remain.

Returns: {unlinked: true, provider}.

Scope: account:security · MCP: trenzhub_unlink_account

curl --fail-with-body -X DELETE 'https://trenzhub.com/api/v1/me/connections/google' \
  -H "Authorization: Bearer $TRENZHUB_API_KEY"

Permanently delete your account and its owned data. Requires your exact email as confirmation. Admin accounts cannot be deleted. All keys and sessions lose access.

Returns: {deleted: true, keysRevoked: true, websiteSessionsRevoked: true}.

Scope: account:security · MCP: trenzhub_delete_account

curl --fail-with-body -X POST 'https://trenzhub.com/api/v1/me/delete' \
  -H "Authorization: Bearer $TRENZHUB_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{"confirmEmail":"you@example.com","confirm":"VALUE"}'

List supported languages and markets for keyword targeting.

Returns: {languages, markets}. Use locale from languages and marketKey from markets in subsequent calls.

Scope: trends:read · MCP: trenzhub_list_markets

No parameters.

curl --fail-with-body -X GET 'https://trenzhub.com/api/v1/markets' \
  -H "Authorization: Bearer $TRENZHUB_API_KEY"

Read shared API/MCP request usage and your website mining quotas. Quotas reset at midnight UTC.

Returns: {plan, billingEnabled, dateKey, resetTimezone, api, mining}. api contains requests, minute, minuteRequests and account limits. mining contains usage and limits for the account role.

Scope: account:read · MCP: trenzhub_get_usage

No parameters.

curl --fail-with-body -X GET 'https://trenzhub.com/api/v1/usage' \
  -H "Authorization: Bearer $TRENZHUB_API_KEY"

Get monthly search history, volume, competition, and bid metrics for a keyword.

Returns: {keyword, slug, hasData, trend, records, avgMonthlySearches, competition, competitionIndex, lowTopOfPageBidMicros, highTopOfPageBidMicros, aggregateMetricResults, rawResults}. trend: {month,value}[]; records: {label,value,display}[]. Bid values are micros; unavailable metrics are null.

Scope: trends:read · MCP: trenzhub_get_keyword_trend

curl --fail-with-body -X GET 'https://trenzhub.com/api/v1/keywords/trend?keyword=AI+agents&locale=en&market=global&years=4' \
  -H "Authorization: Bearer $TRENZHUB_API_KEY"

Find related keywords and demand metrics with pagination.

Returns: {keyword, slug, page, perPage, totalResults, totalPages, hasMore, nextPageAvailable, prevPageAvailable, entriesReturned, storedEntries, isPartial, entries, fetchedAt, chart}. entries contain text, search volume, competition, bid micros, and monthlySearchVolumes. Use nextPageAvailable to paginate.

Scope: trends:read · MCP: trenzhub_get_keyword_ideas

curl --fail-with-body -X GET 'https://trenzhub.com/api/v1/keywords/ideas?keyword=AI+agents&locale=en&market=global&page=1&limit=50' \
  -H "Authorization: Bearer $TRENZHUB_API_KEY"

Export one page of related keyword metrics as CSV. Use page and limit to export additional pages.

Returns: CSV columns: keyword, avgMonthlySearches, competition, competitionIndex, lowTopOfPageBidMicros, highTopOfPageBidMicros.

Scope: trends:read · MCP: trenzhub_export_keyword_ideas

curl --fail-with-body -X GET 'https://trenzhub.com/api/v1/keywords/ideas/export.csv?keyword=AI+agents&locale=en&market=global&page=1&limit=50' \
  -H "Authorization: Bearer $TRENZHUB_API_KEY"

List the projects in your My Trends workspace.

Returns: Array of {id, name, createdAt, updatedAt}. IDs are positive integers; dates are ISO 8601 strings.

Scope: watchlist:read · MCP: trenzhub_list_projects

No parameters.

curl --fail-with-body -X GET 'https://trenzhub.com/api/v1/watchlist/projects' \
  -H "Authorization: Bearer $TRENZHUB_API_KEY"

Create a My Trends project, or return an existing project with the same name.

Returns: {id, name, createdAt, updatedAt}. Returns the existing project for a duplicate name.

Scope: watchlist:write · MCP: trenzhub_create_project

curl --fail-with-body -X POST 'https://trenzhub.com/api/v1/watchlist/projects' \
  -H "Authorization: Bearer $TRENZHUB_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{"name":"Research workspace"}'

Rename a project you own. Duplicate project names return a conflict.

Returns: {updated: true, id, name}.

Scope: watchlist:write · MCP: trenzhub_rename_project

curl --fail-with-body -X PATCH 'https://trenzhub.com/api/v1/watchlist/projects/1' \
  -H "Authorization: Bearer $TRENZHUB_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{"name":"Research workspace"}'

Delete a project you own. Saved keywords remain in My Trends without a project.

Returns: {deleted: true, id}. Keywords remain saved without a project.

Scope: watchlist:write · MCP: trenzhub_delete_project

curl --fail-with-body -X DELETE 'https://trenzhub.com/api/v1/watchlist/projects/1' \
  -H "Authorization: Bearer $TRENZHUB_API_KEY"

List your My Trends keywords, optionally filtered by project, with pagination.

Returns: {items, page, limit, total}. items contain id, keyword, slug, projectId, projectName, metrics, trendPreviewPoints, lastSyncedAt, createdAt and updatedAt.

Scope: watchlist:read · MCP: trenzhub_list_saved_keywords

curl --fail-with-body -X GET 'https://trenzhub.com/api/v1/watchlist/keywords?page=1&limit=50' \
  -H "Authorization: Bearer $TRENZHUB_API_KEY"

Save a keyword to My Trends, refresh its metrics, and optionally assign it to a project you own.

Returns: The saved keyword, including id, keyword, slug, projectId, projectName and current metrics.

Scope: watchlist:write · MCP: trenzhub_save_keyword

curl --fail-with-body -X POST 'https://trenzhub.com/api/v1/watchlist/keywords' \
  -H "Authorization: Bearer $TRENZHUB_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{"keyword":"AI agents","projectId":null}'

Move up to 50 of your saved keywords to a project, or pass null to remove project assignments.

Returns: {updated: true, ids, projectId}.

Scope: watchlist:write · MCP: trenzhub_move_saved_keywords

curl --fail-with-body -X POST 'https://trenzhub.com/api/v1/watchlist/keywords/move' \
  -H "Authorization: Bearer $TRENZHUB_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{"ids":[1],"projectId":null}'

Delete up to 50 saved keywords you own.

Returns: {deleted: true, ids}.

Scope: watchlist:write · MCP: trenzhub_delete_saved_keywords

curl --fail-with-body -X POST 'https://trenzhub.com/api/v1/watchlist/keywords/delete' \
  -H "Authorization: Bearer $TRENZHUB_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{"ids":[1]}'

Refresh the metrics of one saved keyword. Existing metrics are preserved if the provider fails.

Returns: {id, keyword, avgMonthlySearches, competitionIndex, competition, bid micros, latestDataMonth, trendChange3m, trendDirection3m, trendPreviewPoints}.

Scope: watchlist:write · MCP: trenzhub_refresh_saved_keyword

curl --fail-with-body -X POST 'https://trenzhub.com/api/v1/watchlist/keywords/1/refresh' \
  -H "Authorization: Bearer $TRENZHUB_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{}'

Export your saved keyword metrics as CSV, optionally for one project.

Returns: CSV attachment containing saved keywords, project assignments, metrics and trend history.

Scope: watchlist:read · MCP: trenzhub_export_watchlist

curl --fail-with-body -X GET 'https://trenzhub.com/api/v1/watchlist/export.csv' \
  -H "Authorization: Bearer $TRENZHUB_API_KEY"

List your 12 most recent Trends Mining runs for a language and market.

Returns: Array of up to 12 recent runs for the selected language and market, including id, topic, status, counts and dates.

Scope: mining:read · MCP: trenzhub_list_mining_runs

curl --fail-with-body -X GET 'https://trenzhub.com/api/v1/mining/runs?locale=en&market=global' \
  -H "Authorization: Bearer $TRENZHUB_API_KEY"

Start a background mining run using your existing website quota. Poll get_mining_progress every 5 seconds.

Returns: {runId, status:'queued', progressUrl}. Persist runId before polling.

Scope: mining:write · MCP: trenzhub_create_mining_run

curl --fail-with-body -X POST 'https://trenzhub.com/api/v1/mining/runs' \
  -H "Authorization: Bearer $TRENZHUB_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{"locale":"en","market":"global","seedKeyword":"AI agents, automation","industryTopic":"No industry restriction","keywordCount":100}'

Read your mining run, candidates, and logs. Only the run owner can access private results.

Returns: {run, candidates, logs}. run includes topic, status, counts, targeting and filter settings. candidates contain keyword, status, metrics and trendPoints; logs contain ts, level and message.

Scope: mining:read · MCP: trenzhub_get_mining_run

curl --fail-with-body -X GET 'https://trenzhub.com/api/v1/mining/runs/YOUR_RUN_ID' \
  -H "Authorization: Bearer $TRENZHUB_API_KEY"

Poll your mining run status and progress. Wait at least 5 seconds between polls.

Returns: {version, run, queue, recentLogs}. run.status is queued, running, completed, failed or stopped. queue contains queued, checking, pending, results, failed and total. Poll at most every 5 seconds.

Scope: mining:read · MCP: trenzhub_get_mining_progress

curl --fail-with-body -X GET 'https://trenzhub.com/api/v1/mining/runs/YOUR_RUN_ID/progress' \
  -H "Authorization: Bearer $TRENZHUB_API_KEY"

Stop your queued or running mining job and keep its results.

Returns: {runId, status:'stopped'}.

Scope: mining:write · MCP: trenzhub_stop_mining_run

curl --fail-with-body -X POST 'https://trenzhub.com/api/v1/mining/runs/YOUR_RUN_ID/stop' \
  -H "Authorization: Bearer $TRENZHUB_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{}'

Delete your mining run, candidates, and logs.

Returns: {deleted: true, runId}.

Scope: mining:write · MCP: trenzhub_delete_mining_run

curl --fail-with-body -X DELETE 'https://trenzhub.com/api/v1/mining/runs/YOUR_RUN_ID' \
  -H "Authorization: Bearer $TRENZHUB_API_KEY"

Export your mining results as JSON or CSV.

Returns: CSV or JSON attachment of qualified keyword results and full monthly trend history.

Scope: mining:read · MCP: trenzhub_export_mining_run

curl --fail-with-body -X GET 'https://trenzhub.com/api/v1/mining/runs/YOUR_RUN_ID/export?format=json' \
  -H "Authorization: Bearer $TRENZHUB_API_KEY"

List your key names, prefixes, scopes, expiry, and usage. Secret values are never returned.

Returns: Array of up to 100 keys; active keys are always listed first. Fields: id, name, prefix, scopes, createdAt, expiresAt, revokedAt, lastUsedAt, requestCount. Key timestamps are Unix milliseconds. Secrets and hashes are omitted.

Scope: keys:manage · MCP: trenzhub_list_api_keys

No parameters.

curl --fail-with-body -X GET 'https://trenzhub.com/api/v1/keys' \
  -H "Authorization: Bearer $TRENZHUB_API_KEY"

Create a new key. The secret is returned once. New keys cannot exceed the calling key's scopes or expiry.

Returns: {id, name, prefix, scopes, createdAt, expiresAt, key}. key is the secret, returned only at creation.

Scope: keys:manage · MCP: trenzhub_create_api_key

curl --fail-with-body -X POST 'https://trenzhub.com/api/v1/keys' \
  -H "Authorization: Bearer $TRENZHUB_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{"name":"Research workspace","scopes":["trends:read","watchlist:read"],"expiresInDays":90}'

Immediately revoke one of your keys. Revoking the current key ends its API and MCP access.

Returns: {revoked: true, id}.

Scope: keys:manage · MCP: trenzhub_revoke_api_key

curl --fail-with-body -X DELETE 'https://trenzhub.com/api/v1/keys/YOUR_KEY_ID' \
  -H "Authorization: Bearer $TRENZHUB_API_KEY"