{"_id":"rankwright-mcp","_rev":"6-e5ee734a85a0dee6866cadffabae6767","name":"rankwright-mcp","dist-tags":{"latest":"0.4.0"},"versions":{"0.0.0-stage":{"name":"rankwright-mcp","version":"0.0.0-stage","_id":"rankwright-mcp@0.0.0-stage","stub":true,"maintainers":[{"name":"kigen29","email":"emmanuelkigen029@gmail.com"}],"dist":{"shasum":"a931005d284b0fab1797ba2c47b66b57bff00c6b","tarball":"https://registry.npmjs.org/rankwright-mcp/-/rankwright-mcp-0.0.0-stage.tgz","fileCount":2,"integrity":"sha512-swrzbbdhgXFSNmOzbyDCBOZe3ypYmg8exbUbki3WVUOjV1Ys7Ar1a4mUxyIqI0wbZGpXe+ecPSdjcdXTTu09SA==","signatures":[{"sig":"MEUCIQCJtb41K5ob8aFP4oMfnWRpuAH/1dqszKZmLExhOyXBvwIgDhoPL+vv56JEuvEQiTZnbMccRCWxqWdbmclepvonK5s=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":336},"_npmUser":{"name":"kigen29","email":"emmanuelkigen029@gmail.com"},"description":"Temporary package placeholder for staged publishing","directories":{}},"0.2.0":{"name":"rankwright-mcp","version":"0.2.0","keywords":["mcp","model-context-protocol","seo","pull-request","claude","cursor"],"license":"UNLICENSED","_id":"rankwright-mcp@0.2.0","maintainers":[{"name":"kigen29","email":"emmanuelkigen029@gmail.com"}],"homepage":"https://seo-agent-capstone.vercel.app","bugs":{"url":"https://github.com/Kigen29/seo-agent-capstone/issues"},"bin":{"rankwright-mcp":"server.js"},"dist":{"shasum":"973050fb9ea17b273a916e9758651b6657ba341b","tarball":"https://registry.npmjs.org/rankwright-mcp/-/rankwright-mcp-0.2.0.tgz","fileCount":3,"integrity":"sha512-mOBI+8ha4CJ1etq66zg6znEbgM/pfiXLKeHPNYpVF0Oe/OONwV6ReCvYABVVSAkGHnoBCJPYqoC0YvhrPW303w==","signatures":[{"sig":"MEQCIEqSosU1mQxh7SinaSUnzlIfLZnsIEdydp3TMsjTw7Y6AiAHSh1ElCvaDNa+lzP+I/vT8ZR3gqcwaQof783Kbuc4Tw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIEOIvGy+KmBdwQEXEPtRq8i8PKEeOWg8Z/zDQAi1xDBEAiEA4/sRh5Qi8Pp5J1zLT2kj1Ejmpd+aclLX//PszhSEZwc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":827229},"type":"module","engines":{"node":">=20"},"gitHead":"31b18ead9358bbf7cd4b4f35afce884c0db642c9","scripts":{"start":"node server.js"},"_npmUser":{"name":"kigen29","email":"emmanuelkigen029@gmail.com"},"repository":{"url":"git+https://github.com/Kigen29/seo-agent-capstone.git","type":"git"},"_npmVersion":"11.9.0","description":"MCP server for RankWright: read SEO findings, audits, fix outcomes, AI visibility and the schedule from your editor, and open a fix as a pull request.","directories":{},"_nodeVersion":"24.14.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/rankwright-mcp_0.2.0_1791663166410_0.48531040124645863","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"rankwright-mcp","version":"0.2.1","keywords":["mcp","model-context-protocol","seo","pull-request","claude","cursor"],"license":"MIT","_id":"rankwright-mcp@0.2.1","maintainers":[{"name":"kigen29","email":"emmanuelkigen029@gmail.com"}],"homepage":"https://seo-agent-capstone.vercel.app","bugs":{"url":"https://github.com/Kigen29/seo-agent-capstone/issues"},"bin":{"rankwright-mcp":"server.js"},"dist":{"shasum":"ca2b8c79250895d3644fae67db002caab991c464","tarball":"https://registry.npmjs.org/rankwright-mcp/-/rankwright-mcp-0.2.1.tgz","fileCount":4,"integrity":"sha512-NCJyB2UoRWD5/Pc1UBb53jOeJK239OKAsisBvUOAZbtqQp5c3zxhYo7bXvGN50vuIXk4ss2NRczfx7l4Of2K/A==","signatures":[{"sig":"MEUCIBpubRHIZE1TmwqyALVAedSDf20lu+vjvpY3l/LHgepNAiEAq/ijaSvadcwYEJnBhwQL+AHmThC3G5JwMudiuElLXgQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQDKf4r4u819S1p0PUVgjkjBFBPhAYHS0z33vMQahZHuNgIgWDbiMwW2YCMN5b4F4jNi83wKiRXlR6FrJ7aU+LtHo5c=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":828466},"type":"module","engines":{"node":">=20"},"gitHead":"39499a0b7ec1923476393ef49a94e9163ab8f885","scripts":{"start":"node server.js"},"_npmUser":{"name":"kigen29","email":"emmanuelkigen029@gmail.com"},"repository":{"url":"git+https://github.com/Kigen29/seo-agent-capstone.git","type":"git"},"_npmVersion":"11.9.0","description":"MCP server for RankWright: read SEO findings, audits, fix outcomes, AI visibility and the schedule from your editor, and open a fix as a pull request.","directories":{},"_nodeVersion":"24.14.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/rankwright-mcp_0.2.1_1791664903365_0.10297391770398656","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"name":"rankwright-mcp","version":"0.2.2","keywords":["mcp","model-context-protocol","seo","pull-request","claude","cursor"],"license":"MIT","_id":"rankwright-mcp@0.2.2","maintainers":[{"name":"kigen29","email":"emmanuelkigen029@gmail.com"}],"homepage":"https://seo-agent-capstone.vercel.app","bugs":{"url":"https://github.com/Kigen29/seo-agent-capstone/issues"},"bin":{"rankwright-mcp":"server.js"},"dist":{"shasum":"7f555ec33f5baec832eb19aa088f4de346e3697d","tarball":"https://registry.npmjs.org/rankwright-mcp/-/rankwright-mcp-0.2.2.tgz","fileCount":4,"integrity":"sha512-iI6ZnzsXFwAEILavi6UOwj+RRLonzRTFrVpW+RJ0B6UzynO/hzQQ2szDgTOC+f8lOnqeqclGcffy1uVa1E4nBA==","signatures":[{"sig":"MEQCICC9Zw6C+WRV8uQMt5Nj6gcjWXMsM5eXbZUiBa67WgvMAiAyhKSjrqKqm0yFjaX7j0Uzv2jKy4Xj9d8D0vGyzxH9KA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQD0dBNWLisFHfrnbuh+2B1Fa4v3nx1sSzOrvXj6nK7uiwIhAKmKcBUeh+/Iie4jQgn3Rh3eBvuRd7m1x9RTq8vALOTB","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":828711},"type":"module","engines":{"node":">=20"},"gitHead":"08a25e9994a1e87223704e6f49338741fc4f59c4","scripts":{"start":"node server.js"},"_npmUser":{"name":"kigen29","email":"emmanuelkigen029@gmail.com"},"repository":{"url":"git+https://github.com/Kigen29/seo-agent-capstone.git","type":"git"},"_npmVersion":"11.9.0","description":"MCP server for RankWright: read SEO findings, audits, fix outcomes, AI visibility and the schedule from your editor, and open a fix as a pull request.","directories":{},"_nodeVersion":"24.14.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/rankwright-mcp_0.2.2_1791680832756_0.26012295090746673","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"rankwright-mcp","version":"0.3.0","keywords":["mcp","model-context-protocol","seo","pull-request","claude","cursor"],"license":"MIT","_id":"rankwright-mcp@0.3.0","maintainers":[{"name":"kigen29","email":"emmanuelkigen029@gmail.com"}],"homepage":"https://seo-agent-capstone.vercel.app","bugs":{"url":"https://github.com/Kigen29/seo-agent-capstone/issues"},"bin":{"rankwright-mcp":"server.js"},"dist":{"shasum":"181178b0330601d4d40367036f300ebb117e396f","tarball":"https://registry.npmjs.org/rankwright-mcp/-/rankwright-mcp-0.3.0.tgz","fileCount":4,"integrity":"sha512-pw4w4CMT98jGobqpifzo+3HJpL8xT7GqUQ1AqFfC6VT/eS7IsJFwfsON65OhUkZMr4JkrcZyDxysjBqWpraorw==","signatures":[{"sig":"MEYCIQCI+qvCREu708qlA0X9Pf2P6fzW928VH3GY0XxV/NAddwIhAIQfnwrc67gZClwkpH6RWA0M1Z55hmq/VzbRx3gCdZVj","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQDIKqDFiguUnuS381otLeFanHQd1wOhkbppMMkp/V+OagIhAM3bG/i8gD0y1AXK5M2fjVq17bXBXeXP/8mO3a0F4XoR","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":839094},"type":"module","engines":{"node":">=20"},"gitHead":"2744be90c474ad893dd7f8c884ade31220b3de5e","scripts":{"start":"node server.js"},"_npmUser":{"name":"kigen29","email":"emmanuelkigen029@gmail.com"},"repository":{"url":"git+https://github.com/Kigen29/seo-agent-capstone.git","type":"git"},"_npmVersion":"11.9.0","description":"MCP server for RankWright: read SEO findings, audits, fix outcomes, AI visibility and the schedule from your editor, and open a fix as a pull request.","directories":{},"_nodeVersion":"24.14.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/rankwright-mcp_0.3.0_1791696061042_0.9208589957186151","host":"s3://npm-registry-packages-npm-production"}},"0.4.0":{"_id":"rankwright-mcp@0.4.0","bin":{"rankwright-mcp":"server.js"},"bugs":{"url":"https://github.com/Kigen29/seo-agent-capstone/issues"},"dist":{"shasum":"e831ab72c0912b896e21f7401518b6f122448077","tarball":"https://registry.npmjs.org/rankwright-mcp/-/rankwright-mcp-0.4.0.tgz","fileCount":4,"integrity":"sha512-+l5uaYfqIMBmYgFiwlPVybg113TZDwZKlEMbxGYaC1C1WCRLVGxfBfVe3ycziJocbe8q5Rfy8lSFwjNbY/9Wzg==","signatures":[{"sig":"MEUCIQDVrbvGAOgH8xuKE4Vtg2M4be8DsS1MUhiIQThLuJs8CwIgdIQPQGpfAoyvKCguOABvOgFk1F/TOOYQFcy+ZLjHBGI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDpemmfT9gy37SAJJmvsHeQ93vbLQktRgMjNktHB8IKpgIhAMWV4rGnustFaL7R+0gjFo416BrTj+7eX0wA3IdaiShv"}],"unpackedSize":846232},"name":"rankwright-mcp","type":"module","engines":{"node":">=20"},"gitHead":"1fcfcbebd3301b9c57ac365bc1064469135633d2","license":"MIT","scripts":{"start":"node server.js"},"version":"0.4.0","_npmUser":{"name":"kigen29","email":"emmanuelkigen029@gmail.com"},"homepage":"https://seo-agent-capstone.vercel.app","keywords":["mcp","model-context-protocol","seo","pull-request","claude","cursor"],"repository":{"url":"git+https://github.com/Kigen29/seo-agent-capstone.git","type":"git"},"_npmVersion":"11.9.0","description":"MCP server for RankWright: read SEO findings, audits, fix outcomes, AI visibility and the schedule from your editor, and open a fix as a pull request.","directories":{},"maintainers":[{"name":"kigen29","email":"emmanuelkigen029@gmail.com"}],"_nodeVersion":"24.14.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/rankwright-mcp_0.4.0_1791713395921_0.7686338643431778"}}},"time":{"created":"2026-10-10T20:11:29.178Z","modified":"2026-10-11T10:09:56.170Z","0.0.0-stage":"2026-10-10T20:11:29.178Z","0.2.0":"2026-10-10T20:12:46.505Z","0.2.1":"2026-10-10T20:41:43.463Z","0.2.2":"2026-10-11T01:07:12.846Z","0.3.0":"2026-10-11T05:21:01.126Z","0.4.0":"2026-10-11T10:09:56.022Z"},"bugs":{"url":"https://github.com/Kigen29/seo-agent-capstone/issues"},"license":"MIT","homepage":"https://seo-agent-capstone.vercel.app","keywords":["mcp","model-context-protocol","seo","pull-request","claude","cursor"],"repository":{"url":"git+https://github.com/Kigen29/seo-agent-capstone.git","type":"git"},"description":"MCP server for RankWright: read SEO findings, audits, fix outcomes, AI visibility and the schedule from your editor, and open a fix as a pull request.","maintainers":[{"name":"kigen29","email":"emmanuelkigen029@gmail.com"}],"readme":"# rankwright-mcp\n\nThe [RankWright](https://seo-agent-capstone.vercel.app) MCP server. It lets an AI editor (Claude\nCode, Cursor, VS Code and others) read your site's SEO findings, audits, fix outcomes, AI\nvisibility and schedule, and open a fix as a pull request when you allow it.\n\nIt runs on your machine and talks to the RankWright API with a token from your own account.\n\n## Connect\n\n1. Sign in to RankWright, open **Settings, Account and spend**, and create a token under\n   **Connect your editor**. It is shown once.\n2. Add the server to your editor.\n\nClaude Code:\n\n```bash\nclaude mcp add --env SEO_API_URL=https://seo-agent-capstone.onrender.com --env SEO_API_TOKEN=seo_your_token --env npm_config_yes=true --scope user rankwright npx rankwright-mcp\n```\n\nIt is one line with no `--` on purpose, so it can be pasted into PowerShell, the Windows\ncommand prompt or a Unix shell.\n\nCursor (`.cursor/mcp.json`) and most other editors:\n\n```json\n{\n  \"mcpServers\": {\n    \"rankwright\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"rankwright-mcp\"],\n      \"env\": {\n        \"SEO_API_URL\": \"https://seo-agent-capstone.onrender.com\",\n        \"SEO_API_TOKEN\": \"seo_your_token\"\n      }\n    }\n  }\n}\n```\n\n## Tools\n\n| | Tools |\n|---|---|\n| Findings and audits | `list_sites`, `list_findings`, `get_finding`, `get_audit`, `audit_status`, `list_audits`, `audit_changes` |\n| Reports | `get_outcomes`, `get_visibility`, `get_competitor_watch`, `get_schedule` |\n| Billed research | `keyword_ideas`, `keyword_gap` |\n| Billed suggestions, nothing saved | `suggest_competitors`, `suggest_questions`, `find_publications` |\n| Account changes, off by default | `run_audit`, `set_audit_schedule`, `add_tracked_questions`, `change_competitors`, `name_competitor`, `mark_not_us`, `update_site_details`, `add_site`, `connect_repository`, `set_finding_status` |\n| Pull requests, off by default | `fix_finding`, `verify_site` |\n\n## It can only read until you say otherwise\n\nWithout anything else set, the server can only read. There are two things you can allow,\nseparately:\n\n- **Changes to your account**, with `SEO_MCP_ALLOW_ACCOUNT_WRITES=1`: start an audit, set\n  how often a site is audited, add tracked questions, add or remove competitors, update a\n  site's details, dismiss or reopen a finding. All of it can be changed back in the dashboard,\n  and none of it touches your code.\n- **Pull requests on your repository**, with `SEO_MCP_ALLOW_REPO_WRITES=1`: open a fix for a\n  finding, and verify a Search Console property. A pull request never goes to your default\n  branch, a person still merges it, and one session opens at most three\n  (`SEO_MCP_MAX_PRS` changes that).\n\n`SEO_MCP_ALLOW_WRITES=1` allows both. The dashboard has a checkbox for each, and writes the\nconfig for you.\n\n## Environment\n\n| Variable | |\n|---|---|\n| `SEO_API_URL` | The API's address. Required. |\n| `SEO_API_TOKEN` | A token from your account. Required. |\n| `SEO_MCP_ALLOW_ACCOUNT_WRITES` | `1` to let it change settings in your account. Default off. |\n| `SEO_MCP_ALLOW_REPO_WRITES` | `1` to let it open pull requests. Default off. |\n| `SEO_MCP_ALLOW_WRITES` | `1` for both of the above. |\n| `SEO_MCP_MAX_PRS` | Pull requests one session may open. Default 3. |\n\nThe first call after a quiet spell can take up to a minute: the API runs on a free instance that\nsleeps when idle.\n\n## Licence\n\nMIT.\n","readmeFilename":"README.md"}