nod-shout

mcp server for nod social. turns links you share with your ai agent into a curated public page. zero friction link curation.

setup

1. install dependencies

cd ~/code/nod-shout
npm install

2. set up supabase

run the migration against your supabase project:

# via supabase cli
supabase db push

# or manually run supabase/migrations/001_initial_schema.sql in the sql editor

3. configure environment

export SUPABASE_URL="https://your-project.supabase.co"
export SUPABASE_SERVICE_KEY="your-service-role-key"

4. build and run

npm run build
npm start

# or for development
npm run dev

5. connect to your agent

add to your mcp config (e.g. .mcp.json):

{
  "mcpServers": {
    "nod-shout": {
      "command": "node",
      "args": ["~/code/nod-shout/dist/index.js"],
      "env": {
        "SUPABASE_URL": "https://your-project.supabase.co",
        "SUPABASE_SERVICE_KEY": "your-service-role-key"
      }
    }
  }
}

tools

| tool | description | |------|-------------| | shout_save_link | save a link with auto-extracted metadata and ai summary | | shout_list | list your shouts, filterable by tag/collection | | shout_remove | delete a shout | | shout_create_collection | create a collection to organize shouts | | shout_list_collections | list your collections | | shout_generate_digest | generate a digest of recent shouts (stub) | | shout_follow | follow another user's shouts | | shout_unfollow | unfollow a user | | shout_feed | aggregated feed from followed users | | shout_settings | configure auto-detect, visibility, digest frequency |

auth note

v1 uses user_id passed as a tool parameter. proper auth integration coming later.

ai summary

v1 uses a stub that returns the page description as summary and extracts basic keyword tags. real ai summarization (claude/openai) is a TODO.