SubReply
Integraties

Koppel je AI aan SubReply

SubReply stelt zijn zes Reddit-prospectietools beschikbaar via een Model Context Protocol-server, de standaard die Claude, ChatGPT, Gemini en n8n spreken. Koppel hem in dertig seconden en je assistent zoekt, schrijft en publiceert zonder dat je één HTTP-verzoek schrijft.

Eén endpoint, alleen POST, streambaar HTTP-transport zonder sessie:

Server-URL
https://subreply.io/api/mcp

Twee manieren om je te authenticeren: OAuth voor de connectors van de bekende assistenten, een API-sleutel voor al het andere.

OAuth-koppeling (aanbevolen) — claude.ai, ChatGPT, Gemini

De kortste weg, en zonder sleutel om ergens te plakken. De connector stuurt je naar SubReply, je logt in met je gewone account en het staat er.

Claude (claude.ai)
  1. Instellingen → Connectors → Connector toevoegen
  2. Plak de URL: https://subreply.io/api/mcp
  3. Verbinden → inloggen bij SubReply → toestemming geven
Bekijk de volledige API-doc →
ChatGPT
  1. Instellingen → Developer Mode → Apps → Nieuwe connector
  2. URL: https://subreply.io/api/mcp, authenticatie OAuth
  3. Vereist een Pro-, Business-, Enterprise- of Edu-abonnement
Bekijk de volledige API-doc →
Gemini
  1. Google AI Studio → Extensions → Custom MCP
  2. URL: https://subreply.io/api/mcp
  3. Authenticatie via SubReply-OAuth
Bekijk de volledige API-doc →

De toestemming geldt 30 dagen. Daarna opent de client hetzelfde scherm opnieuw en is één klik genoeg.

Publiceren kan niet via OAuth

publish_reddit_comment weigert OAuth-koppelingen: schrijven op Reddit vraagt een API-sleutel waarvan de publicatietoestemming aanstaat in je API-instellingen. De andere vijf tools werken gewoon.

Koppeling met API-sleutel — Claude Code, Claude Desktop, n8n

De sleutel reist mee in de Authorization-header. Elk verzoek wordt opnieuw geauthenticeerd, dus een ingetrokken sleutel stopt op datzelfde moment met werken in plaats van pas als een sessie verloopt. Het is dezelfde sr_live_…-sleutel als voor de REST v1-API, aan te maken op je pagina met API-sleutels.

Claude Code en Claude Desktop

Terminal
claude mcp add --transport http subreply https://subreply.io/api/mcp \
  --header "Authorization: Bearer sr_live_UW_API_SLEUTEL"

Of rechtstreeks in het MCP-configuratiebestand, als je het liever in versiebeheer houdt:

MCP-configuratie
{
  "mcpServers": {
    "subreply": {
      "type": "http",
      "url": "https://subreply.io/api/mcp",
      "headers": {
        "Authorization": "Bearer sr_live_UW_API_SLEUTEL"
      }
    }
  }
}

n8n

Voeg een MCP Client-node toe en vul vier velden in:

  • Endpoint — https://subreply.io/api/mcp
  • Server Transport — HTTP Streamable
  • Authentication — Header Auth
  • Header Auth-credential — naam Authorization, waarde Bearer sr_live_…

De node toont dan alle zes tools. Let op de timeout: publish_reddit_comment kan twee minuten duren, ruim boven de standaard van n8n.

Controleren of hij antwoordt

Als een client weigert te koppelen, beslecht deze aanroep de kwestie: hij hangt van geen enkele MCP-client af en kost geen credits.

cURL
curl -s -X POST https://subreply.io/api/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer sr_live_UW_API_SLEUTEL" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

Zes tools in de lijst betekent dat de server in orde is en het probleem aan de clientkant zit. Een 401 betekent de sleutel. Een 406 betekent de Accept-header: het transport eist beide types, ook al antwoordt het met puur JSON. De tool ping doet hetzelfde werk zodra je client gekoppeld is: hij antwoordt pong en bewijst meteen dat je sleutel werkt.

Beschikbare tools

ToolWat hij doetCreditsGoed om te weten
pingBeschikbaarheidssonde. Antwoordt „pong” en bevestigt dat de sleutel geldig is.gratis—
get_account_statusCreditsaldo en abonnementsstatus. De tool om aan te roepen wanneer een andere „onvoldoende credits” antwoordt.gratis—
list_projectsProjecten van het account: id, naam, doeltaal, zoekwoorden, status van de agent.gratis—
scrape_reddit_opportunitiesScant subreddits en geeft de posts terug waarvan de auteur op een klant lijkt, gescoord op relevantie.gratisproduct_description sterk aanbevolen
generate_reddit_commentSchrijft een natuurlijke reactie, in de taal van de draad, gemaakt om geen shadowban uit te lokken. Publiceert niets.35Idempotent op post_url
publish_reddit_commentPubliceert echt op Reddit, vanaf een account uit het SubReply-park achter een residentiële proxy.50Opt-in per API-sleutel vereist

Dezelfde economie als de REST-API: zoeken is gratis, alleen productie wordt gefactureerd. Een scan die niets vindt kost dus nooit iets.

Scannen is gratis, maar niet voor iedereen open

Scannen kost niets, maar vereist wel een saldo van minstens 35 credits — de prijs van één reactie. Daaronder weigert de tool: scrapen voor een account dat er daarna niets mee kan produceren helpt niemand. get_account_status en list_projects blijven wél aanroepbaar bij nul credits. Dat is precies hun nut.

Afschrijvingen zijn idempotent per post: valt het netwerk weg en speelt je agent generate_reddit_comment opnieuw af op dezelfde Reddit-URL, dan geeft de tweede aanroep credits_used: 0 terug.

Limieten

ToolLimiet
scrape_reddit_opportunities60 aanroepen / minuut
generate_reddit_comment20 aanroepen / minuut
publish_reddit_comment5 aanroepen / minuut
get_account_statuslist_projects60 aanroepen / minuut
pinggeen

Quota worden geteld per account en per tool: generate_reddit_comment uitputten remt je andere tools niet af en de accounts van anderen evenmin. ping is bewust onbeperkt — het is de sonde, en die moet juist bereikbaar blijven op het moment dat je erop hamert omdat je een storing vermoedt.

Publiceren op Reddit

publish_reddit_comment schrijft echt op Reddit

De reactie is openbaar zodra de tool terugkeert, geplaatst vanaf een account uit het SubReply-park achter een residentiële proxy. Verwijderen maakt de melding aan de poster niet ongedaan. Roep deze tool pas aan als een mens de exacte tekst heeft goedgekeurd.

Daarom staat hij standaard uit. Om hem aan te zetten, open je je pagina met API-sleutels en schakel je publiceren in op de betreffende sleutel.

De toestemming hangt aan de sleutel en niet aan het account, en dat is bewust: een sleutel voor een n8n-publicatieworkflow mag hem hebben terwijl een sleutel in een gespreksassistent hem niet heeft. Na een lek breekt publiceren uitzetten op die ene sleutel geen enkele andere integratie.

  • Maximaal 5 aanroepen per minuut, ver onder wat de infrastructuur aankan. Een reeks publicaties kost niet alleen saldo: het kost een shadowban.
  • De 50 credits worden achteraf afgeschreven, zodra de publicatie bevestigd is. Een mislukking kost niets.
  • Deze tool is niet idempotent: twee aanroepen op dezelfde URL laten twee reacties achter. De tweede is gratis, maar hij staat er wel degelijk.
  • Reken op twee minuten per aanroep — een echte browser opent de post en typt de reactie. Stel de timeout van je client daarop af.

MCP-specifieke fouten

Een mislukte tool werpt nooit een JSON-RPC-uitzondering op: hij geeft een resultaat terug met isError: true, met een zin die de agent kan lezen. Vier gevallen bestaan alleen aan MCP-kant.

GevalWat de tool teruggeeft
Quotum overschredenisError: true en de wachttijd in seconden. Er wordt niets afgeschreven.
Onvoldoende creditsisError: true en het ontbrekende saldo. Vul bij op de facturatiepagina.
publish_reddit_comment zonder opt-inisError: true: publiceren staat uit op die sleutel. Zet het aan in je API-instellingen.
publish_reddit_comment via OAuthisError: true: publiceren vraagt een API-sleutel, een OAuth-koppeling volstaat niet.

Het quotumbericht bevat de wachttijd, zodat je agent weet wanneer hij weer verder kan in plaats van te blijven doorlopen:

Antwoord van de tool
Rate limit exceeded for generate_reddit_comment:
20 calls per minute maximum. Retry in 34 seconds.
No credits were charged.

De weigering komt vóór alle bedrijfslogica: er wordt niets aangeroepen en niets afgeschreven. Een agent die zijn 20 generaties per minuut opbrandt, is geen enkele credit kwijt.

Een lege lijst is geen fout

scrape_reddit_opportunities filtert op versheid, klantsignaal en productfit. Nul resultaten is een normaal antwoord. product_description meegeven maakt veel uit — zonder die beschrijving wijst de drempel voor productfit bijna alles af.

De HTTP-codes en het foutformaat van de REST-API staan op de pagina foutcodes.

Volledige foutcodes