Njord MCP
Overview
A read-only DOE analytics and lookup MCP for account, stakeholder, campaign, website, signal, meeting-note, and report analysis.
Endpoint: See endpoint from your workspace
Package: Njord DOE
Setup
Create MCP tokens from DOE Settings and give the endpoint plus token secret to the approved MCP client.
What your client needs
- The MCP endpoint URL
- The generated token value
Steps
- Open Settings -> API Tokens.
- Click Generate token.
- Confirm the Space ID.
- Keep the profile as MCP Space Read Only unless there is a specific reason to choose another profile.
- Review the MCP endpoint shown in the dialog.
- Use the copy icon next to the endpoint if you want to paste it directly into the client configuration.
- Choose an expiry date if the token should stop working automatically after a certain time.
- Click Generate.
- Copy the token immediately from the success dialog.
- Store it in a safe place before closing the dialog.
The secret token value is shown only once. If the success dialog is closed before saving it, create a new token or rotate the existing one.
Available tools
Reports
Use report tools when you already know the report type or need ranked, score-based, report-specific summaries.
list_report_catalog: See available report types and report behavior.run_report: Run report-backed business analysis.
Accounts and stakeholders
Use entity and roster tools for direct rows and specific records, not report abstractions.
get_account: Fetch one account when you already know the account id.list_accounts: List account rosters and filter rows by owner, industry, market segment, RMF, marketing impact, status, country, type, or metrics.list_account_facets: Get aggregate account counts by category.get_space_targeting_summary: Get workspace-level targeting and impact summary.get_stakeholder: Fetch one stakeholder when you know the stakeholder id.list_stakeholders: List stakeholder rosters and filter by account, deal, owner, source, location, type, or impact.
Campaigns and ads
Use campaign tools for campaign inventory and direct campaign or ad performance.
list_campaigns: Browse campaigns, filter by platform, ids, status, or duration, and sort campaign rows.list_campaign_ads: Inspect ad rows inside one campaign.get_campaign_ad: Fetch one specific ad detail row by platform and ad id.list_campaign_performance: Rank campaigns by direct campaign-level metrics.
Website behavior
Use website tools for tracked web behavior, not internal activity logs.
list_website_journeys: General-purpose website behavior listing and visit-timeline tool.list_website_visits: Return the raw visit timeline for one known website lead id.list_website_top_pages: Show most-visited pages for one known account.get_website_tracking_insights: Aggregate website-tracking performance.
Signals and meetings
Use signal and meeting-note tools for safe business evidence without exposing raw transcripts.
list_signals: Return DOE signal rows for media, news, website, company, and deal-expanded stakeholder signals.list_meeting_notes: List meeting-note records and safe summary rows.search_meeting_notes: Search meeting-note content semantically or by text.
Njord AI helper
Use the helper when you want synthesis or plain-language follow-up over the same context.
ask_njord_ai: Ask a public Njord model for a conversational answer.
Reports
| Code | Report | Notes |
|---|---|---|
AMPS | Account media summary | Frontend Media Summary report for account-level media activity. |
APIFP | Product Interest Fit | Best PIF report. Supports LAST_WINDOW, LAST_30_DAYS, and LAST_7_DAYS. |
AITP | Account individual targeting performance | Bounded-window deltas or all-time cumulative. |
ALIP | Account LinkedIn performance | Bounded window with possible all-time fallback. |
AIPP | Account IP targeting performance | IP targeting clicks, impressions, and click-through rate. |
AGEOP | Account geo targeting performance | Geo targeting clicks, impressions, and click-through rate. |
AWP | Targeted-account website performance | Bounded windows use spanVisits. |
SMP | Space Media Performance | One aggregate row per selected media technique with clicks, impressions, CTR, basis, reporting date, and availability. |
SMPC | Space Media Period Comparison | Current-vs-previous clicks and impressions by comparable media technique. |
STAM | Space Top Account Movers | Account-level media gainers and decliners for the selected technique and metric. |
ITMP | Stakeholder individual-targeting performance | Best stakeholder performance report. |
NTAAR | Non-targeted LinkedIn org performance | Bounded window with possible fallback. |
NTAWP | Non-targeted website company or lead performance | Bounded windows use spanVisits. |
Operations and limits
If you hit a rate limit, check the Retry-After response header and wait that long before retrying. Reduce request volume and avoid sharing one noisy token across multiple clients.
- POST /mcp
- 200/minute, 2,000/hour
- 100/minute, 1,000/hour
- 120 seconds
Review
Use the API Tokens table to identify active, old, expired, or risky tokens.
- Token key preview
- Type
- Profile
- Status
- Created date
- Expiry date
Rotate
Use Rotate when the integration should keep working but the secret should change.
- Use after exposure, ownership changes, unsafe sharing, or scheduled security rotation
- Rotation revokes the current secret and issues a new secret value
- Copy the new token immediately and update the MCP client or secret manager
Revoke
Use Revoke when the token should stop working completely.
- Use when an integration is no longer needed, was created by mistake, was decommissioned, or is no longer trusted
- Revocation permanently disables the token for future use
- Create a new token if the integration still needs access later
Expire
Use expiry dates to limit the damage window if a token is exposed.
- Strongly recommended for tests, proof-of-concepts, external partners, migrations, limited rollouts, and short-lived automations
- Longer-lived tokens may be reasonable for stable internal workflows with clear ownership, secure storage, and regular review
- If unsure, choose an expiry date
Safety checklist
- Create one token per tool or workflow.
- Prefer expiring tokens unless there is a clear long-term need.
- Save the token immediately because the secret is shown only once.
- Store tokens in a secure secret manager or password manager.
- Rotate tokens when ownership changes or exposure is suspected.
- Revoke tokens you no longer need.
- Periodically review active tokens in the API Tokens table.
Things to know
Many tools are specialized
Use list_campaign_performance for campaigns, ITMP for stakeholder performance, and list_website_journeys for web journeys.
top is not the same as take
Use take for neutral pagination and top only for the report's positive-only Top-N behavior.
Website tracking is its own domain
Website tools refer to tracked lead or account web behavior, not audit logs, meeting activity, or generic signal rows.
Meeting-note tools are safe summaries
The meeting-note tools are designed for structured insight and safe summaries, not transcript exports.
Example prompts
- Show the top targeted accounts by overall clicks.
- Which accounts have the strongest Product Interest Fit in the last 30 days?
- Which stakeholders clicked ads in the last 7 days?
- What are the top website pages visited by account X?
- Rank our LinkedIn campaigns by clicks.
- Show non-targeted companies visiting the website this month.
- Search meeting notes for procurement objections.
- Give me the targeting summary for the workspace.
Strongest for
- Account prioritization
- Product Interest Fit analysis
- Stakeholder engagement analysis
- Campaign inspection and campaign ranking
- Website-behavior analysis
- Targeting summary and signal review
- Meeting-note discovery and summarization
Not designed for
- Write operations
- Unsupported report types
- Workflows that require hidden or internal endpoints
- Assuming one report's window semantics apply to another report