Virkely for AI-assistenter og utviklere
Virkely eksponerer sin database over norske offentlige støtteordninger som et MCP-endepunkt over HTTP. Enten du jobber i Claude Desktop, ChatGPT Pro, Cursor — eller skriver et script i Python eller Node — kan du bruke de samme fire verktøyene uten å sette opp noen klient først.
Hva fungerer hvor
| Hvordan du spør | Hva du får |
|---|---|
| Claude Desktop, ChatGPT Pro/Plus/Team, Cursor | Full MCP-kobling. AI-assistenten kaller verktøyene automatisk under samtalen. |
| ChatGPT (gratis), Gemini, web-Claude | Web-fetch. Assistenten kan besøke virkely.no og hente data. Si f.eks. «finn støtteordninger til min bedrift via virkely.no». |
| Egne script (Python, Node, curl) | Direkte HTTP-kall mot /api/mcp eller markdown-endepunktene. |
Prøv det nå — én curl-kommando
Du trenger ikke en MCP-klient. Dette kjører direkte fra terminalen:
curl -X POST https://virkely.no/api/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "search_grants",
"arguments": {
"query": "tilskudd til produktutvikling for oppstartsbedrift innen IT og programvare"
}
}
}'Du får et JSON-svar med rangerte treff, hver med navn, slug, kort beskrivelse og en lenke til full ordning.
Tre vanlige integrasjoner
1 — Claude Desktop, ChatGPT Pro eller Cursor (MCP)
Lim inn URL-en https://virkely.no/api/mcp som en ny MCP-kobling (ingen autentisering kreves). Verktøyene dukker opp automatisk. Detaljert oppsettsguide →
2 — Python
import requests
response = requests.post(
"https://virkely.no/api/mcp",
headers={
"Content-Type": "application/json",
"Accept": "application/json, text/event-stream",
},
json={
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "search_grants",
"arguments": {"query": "grønn industri i Nord-Norge"},
},
},
timeout=30,
)
print(response.json())3 — Node.js / Next.js
const res = await fetch("https://virkely.no/api/mcp", {
method: "POST",
headers: {
"Content-Type": "application/json",
Accept: "application/json, text/event-stream",
},
body: JSON.stringify({
jsonrpc: "2.0",
id: 1,
method: "tools/call",
params: {
name: "search_grants",
arguments: { query: "forskningsstøtte til SMB" },
},
}),
});
const data = await res.json();Verktøy
| Navn | Formål |
|---|---|
lookup_norwegian_company | Slår opp en norsk bedrift i Brønnøysundregistrene. Parameter: organizationNumber (9-sifret, med eller uten mellomrom/bindestrek). |
search_grants | Semantisk (RAG) vektorsøk. Skriv på norsk i HyDE-stil. Parametere: query, limit (default 15, maks 25), minScore (default 0.3), region. |
get_grant_details | Henter fullstendige detaljer om en enkelt støtteordning basert på slug. |
list_grant_providers | Paginert liste over tilskuddsgivere. Parametere: page (default 1), pageSize (default 10, maks 25). |
For detaljert anbefalt flyt, se hele systemprompten som returneres i initialize-responsen fra /api/mcp.
Markdown-endepunkter (for crawlere uten kode-kjøring)
AI-assistenter som bare kan gjøre web-fetch, får rent maskinlesbart innhold via Accept: text/markdown eller .md-suffiks:
https://virkely.no/ordninger.mdhttps://virkely.no/tilskuddsgivere.mdhttps://virkely.no/statistikk.mdhttps://virkely.no/tildelinger.md
Full oversikt: llms-full.txt.
Ratebegrensninger
- 50 forespørsler/minutt per IP, samlet pott for alle verktøy (ingen egen grense for
search_grants). - Ved overskridelse returneres HTTP 429 med JSON-RPC feilkode
-32000(rate_limit_exceeded) og enRetry-After-header som angir sekunder til pott frigjøres (minimum 1 sekund). - Vent og prøv igjen — ikke loop.
Finn ut mer
- MCP-oversikt — alle Virkelys MCP-servere
- Grant Matching MCP — detaljert oppsettsguide
- llms.txt · llms-full.txt
- Kontakt: kontakt@virkely.no