Docs
Frequently asked questions
- What does uprank actually do?
- It runs a research → evidence → brief → draft → claim-check → scoring pipeline for each article, then lets you push a version to your CMS (Strapi) as a draft. Every claim is traced to a source and every quality gate is enforced before anything ships.
- How does uprank keep AI-written articles from inventing facts?
- Research runs before drafting and produces an Evidence Pack of attributable sources. Every citation must point to a source in that pack and each high-risk claim is checked against its source. An invented citation or an unsupported high-risk claim is a hard gate: the article cannot be published until it is fixed. The full rules are at https://uprank.devino.ca/quality-gates.
- How is uprank different from an AI blog writer?
- It treats publishing as a gated editorial process, not a text generator. Research comes before drafting, every draft is scored on 11 dimensions against published thresholds, and a draft that fails a hard gate is blocked instead of shipped. Drafts go to your CMS as drafts by default.
- Does uprank guarantee rankings or traffic?
- No. Nobody can promise rankings, and uprank does not try. It enforces what it can check before publishing: evidence for claims, information gain, practical value, brand fit, readability and risk.
- How do I connect an AI coding agent?
- Copy the "Onboard your agent" sentence from https://uprank.devino.ca/agent-setup and paste it into your agent. It fetches https://uprank.devino.ca/agent-setup/prompt.md and registers the MCP server itself. Per-agent guides are on the same page.
- Where do I get an MCP token?
- A workspace OWNER issues one at https://uprank.devino.ca/mcp. The raw token is shown once; tokens are stored hashed. Revoke and re-issue if you lose it.
- Which scopes should a first token have?
- Read-only: article:read, brand:read, campaign:read. Add research:run, article:write, quality:run to research, draft and score, and publication:draft to record draft publications. publication:live is never granted by default.
- Why does the MCP server return 401?
- The token is missing, revoked, expired, or its credential name starts with "dev:" while the server runs in production. Issue a fresh credential without a dev: prefix.
- Can an agent publish live?
- Only with a credential that holds publication:live, the literal confirmation confirm: "PUBLISH LIVE", and a passing, non-stale quality assessment on the article version. Today the call records a live publication request in uprank; it does not push anything to the CMS. There is no separate human-approval check, so grant publication:live only to an agent you trust. Every call is audited.
- Why did my article fail the quality gate?
- The Quality tab lists every blocker: a score under its minimum (evidence, information gain, practical value, brand fit, readability), risk over its maximum, or a failed integrity check such as an invented citation. Fix the flagged sections with article_revise or the in-app editor, then re-score. The thresholds are listed at https://uprank.devino.ca/quality-gates.
- What CMS can uprank publish to?
- Strapi only, via a validated connection on the Connections page. The Publishing tab pushes a draft to Strapi once the version has passed its hard gates; you publish from Strapi after review. Drafts are idempotent, so pushing again never creates duplicates.
- Is my workspace data isolated from other tenants?
- Yes. Tenancy and scopes are derived from the session or the MCP credential, never from request input. Cross-organization ids resolve to NOT_FOUND.
- How do I get support?
- Email [email protected] with your workspace name and, for pipeline issues, the workflow run id from the Trace tab.