Skip to content
Back to search

constile-mcp

MCP server that reads web pages for an AI assistant and handles Constile ads the way the person chose.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/constile--constile-mcp/badge.svg)](/listings/constile--constile-mcp)

HTML

<a href="/listings/constile--constile-mcp"><img src="/api/listings/constile--constile-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 69 lines
  1. # constile-mcp
  2. An MCP server that gives an AI assistant a `read_article` tool. When a
  3. publisher's page carries a Constile ad, the tool handles it the way the person
  4. chose.
  5. Constile lets publishers keep being paid when assistants read their pages.
  6. Instead of the page's ads, the person sees one labeled sponsored message in the
  7. assistant's answer, and the advertiser pays the publisher. It costs the person
  8. nothing and shares nothing about them.
  9. ## Add it to your assistant
  10. It needs Node.js 20 or later. In any client that runs MCP servers over stdio,
  11. add a server that runs `npx -y constile-mcp`. For example, in a client's
  12. `mcpServers` settings:
  13. ```json
  14. {
  15. "mcpServers": {
  16. "constile": { "command": "npx", "args": ["-y", "constile-mcp"] }
  17. }
  18. }
  19. ```
  20. In Claude Code:
  21. ```sh
  22. claude mcp add constile -- npx -y constile-mcp
  23. ```
  24. ## Tools
  25. | Tool | What it does |
  26. |---|---|
  27. | `read_article` | Fetches a page. When the page carries a Constile ad, it follows the person's saved choice, and returns the page with the sponsored message to show. |
  28. | `report_sponsored_message` | Tells the publisher the message is in the answer (`prepared`) or that the person has seen it (`delivered`). |
  29. | `set_constile_preference` | Saves the person's choice: `accept`, `ask`, or `decline`. Call it only when the person says so. |
  30. | `get_constile_preference` | Returns the saved choice. Until one is saved, it's `ask`. |
  31. ## Settings
  32. | Variable | What it sets | Default |
  33. |---|---|---|
  34. | `CONSTILE_PREFS` | Where the person's choice is saved | `~/.config/constile/preferences.json` |
  35. | `CONSTILE_UA` | The user agent the tool fetches with | `ConstileMCP-User/0.1 (+https://constile.app)` |
  36. The server keeps only that choice, on the person's own machine. It sends
  37. nothing about the person or the conversation.
  38. ## Build from source
  39. The source is at <https://github.com/Constile/constile-mcp>.
  40. ```sh
  41. npm install
  42. npm test
  43. npm run build
  44. ```
  45. ## Support
  46. Write to <hello@constile.app>. For building your own agent, see
  47. [`constile-agent-sdk`](https://www.npmjs.com/package/constile-agent-sdk), and
  48. for the API, <https://constile.app/developers>.
  49. ## License
  50. MIT. See LICENSE.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.