Siirry pääsisältöön
EU ALV-tiedot

Model Context Protocol

EU:n ALV-MCP-palvelin

Anna tekoälyavustajallesi EU:n ajantasaiset ALV-kannat, ALV-laskelmat, tulevat kantojen muutokset ja ALV-numeroiden VIES-tarkistukset. Maksuton, vain luku ja ilman rekisteröitymistä.

  • Streamable HTTP
  • Ei rekisteröitymistä eikä API-avainta
  • Vain luku

Yhdistä tekoälyasiakkaasi

Valitse asiakas ja seuraa vaiheita. Se vie noin minuutin.

  1. 1

    Avaa Claudessa Settings → Connectors ja valitse Add custom connector.

  2. 2

    Anna nimeksi EU VAT Info, liitä palvelimen URL ja valitse Add.

  3. 3

    Ota EU VAT Info käyttöön keskustelussa työkaluvalikosta ja kysy ALV:sta.

  1. 1

    Suorita tämä komento päätteessä:

    Terminal

    claude mcp add --transport http eu-vat-info https://vat.businesspress.io/api/mcp
  2. 2

    Käynnistä Claude Code ja kysy ALV:sta. Tarkista yhteys kirjoittamalla /mcp.

  1. 1

    Lisää tämä projektisi tiedostoon .vscode/mcp.json tai suorita komentopaletista MCP: Add Server ja valitse HTTP.

    .vscode/mcp.json

    {
    "servers": {
        "eu-vat-info": {
            "type": "http",
            "url": "https://vat.businesspress.io/api/mcp"
        }
    }
}
  2. 2

    Avaa Copilot Chat agenttitilassa ja kysy ALV:sta.

  1. 1

    Lisää tämä tiedostoon ~/.cursor/mcp.json tai projektin tiedostoon .cursor/mcp.json.

    mcp.json

    {
    "mcpServers": {
        "eu-vat-info": {
            "url": "https://vat.businesspress.io/api/mcp"
        }
    }
}
  2. 2

    Tarkista kohdasta Cursor Settings → MCP, että eu-vat-info on käytössä, ja kysy ALV:sta keskustelussa.

  1. 1

    Lisää URL etä-MCP-palvelimeksi Streamable HTTP -yhteydellä ilman todennusta. Useimmat asiakkaat hyväksyvät tämän määrityksen:

    JSON

    {
    "mcpServers": {
        "eu-vat-info": {
            "type": "http",
            "url": "https://vat.businesspress.io/api/mcp"
        }
    }
}
  2. 2

    ChatGPT:n liittimet kehittäjätilassa, Windsurf, Zed ja muut MCP-asiakkaat yhdistävät samalla tavalla.

Mitä avustajasi osaa

Kuusi vain luku -työkalua. Avustaja lukee niiden kuvaukset ja valitsee jokaiseen kysymykseen oikean.

  • Kaikki ALV-kannat

    get_all_vat_rates

    Kaikki yleiset, alennetut, erittäin alennetut ja välikannat EU:ssa ja viidessä muussa Euroopan maassa.

    Parametrit

    Ei parametreja

    Kokeile kysyä: Missä EU-maassa on alhaisin yleinen ALV-kanta?

  • Yhden maan kannat

    get_country_vat_rate

    Voimassa olevat kannat, valuutta ja viimeisin päivitys yhdelle maalle.

    Parametrit

    • country string · pakollinen

    Kokeile kysyä: Mitkä ovat Itävallan ALV-kannat?

  • ALV-laskelma

    calculate_vat

    Lisää ALV:n verottomaan summaan tai erottaa sen verollisesta summasta millä tahansa kantatyypillä.

    Parametrit

    • amount number · pakollinen
    • country string · pakollinen
    • mode string · valinnainen
    • rate_type string · valinnainen

    Kokeile kysyä: Paljonko on 1 250 euroa plus Saksan ALV?

  • Kantojen vertailu

    compare_vat_rates

    Kahden–kymmenen maan kannat rinnakkain.

    Parametrit

    • countries array · pakollinen

    Kokeile kysyä: Vertaa Espanjan, Portugalin ja Italian ALV:tä.

  • Kantojen muutokset

    get_vat_rate_changes

    Kirjatut ja tulevat kantojen muutokset voimaantulopäivineen ja lähteineen.

    Parametrit

    • country string · valinnainen
    • upcoming_only boolean · valinnainen
    • limit integer · valinnainen

    Kokeile kysyä: Mitkä EU:n ALV-kannat muuttuvat seuraavaksi?

  • ALV-numeron tarkistus

    validate_vat_number

    Käyttää VIESiä

    Tarkistaa ALV-numeron VIESistä ja palauttaa rekisteröidyn nimen ja osoitteen, jos jäsenvaltio julkaisee ne.

    Parametrit

    • country_code string · pakollinen
    • vat_number string · pakollinen

    Kokeile kysyä: Onko LT100019070512 voimassa oleva ALV-numero?

Kokeile

Lähetä palvelimelle oikea pyyntö selaimestasi.

POST /api/mcp

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
        "protocolVersion": "2025-06-18",
        "capabilities": {},
        "clientInfo": {
            "name": "browser",
            "version": "1.0.0"
        }
    }
}

                        
Vastaus näkyy tässä.

                    

                


                
Komentoriviltä

                

                    

                        
curl

                        
                    

                    
curl -X POST https://vat.businesspress.io/api/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"calculate_vat","arguments":{"amount":100,"country":"DE","mode":"add"}}}'

                

            


            

                
Tekniset tiedot

                

                                            

                            
Päätepiste

                            
https://vat.businesspress.io/api/mcp

                        

                                            

                            
Siirto

                            
Streamable HTTP ja JSON-vastaukset

                        

                                            

                            
Protokollaversiot

                            
2025-06-18, 2025-03-26, 2024-11-05

                        

                                            

                            
Todennus

                            
Ei mitään

                        

                                            

                            
Käyttöoikeus

                            
Vain luku

                        

                                            

                            
Kohtuullinen käyttö

                            
120 pyyntöä minuutissa IP-osoitetta kohden, joista enintään 20 ALV-numeron tarkistusta

                        

                                            

                            
Tiedot

                            
Euroopan komission ALV-kannat, päivitetään päivittäin

                        

                                        

                        
Löydettävyys

                        

                            
                        

                    

                

            

        


        

            
Kysymyksiä

            

                                    

                        
                            Mikä on MCP?
                            
                        
                        
Model Context Protocol on avoin standardi, jonka avulla tekoälyavustajat voivat käyttää ulkoisia työkaluja ja tietoja. Kun yhteys on muodostettu, avustajasi hakee ajantasaiset ALV-tiedot sen sijaan, että luottaisi muistiinsa.

                    

                                    

                        
                            Tarvitsenko tilin tai API-avaimen?
                            
                        
                        
Et. Palvelin on maksuton eikä vaadi rekisteröitymistä. Kohtuullisen käytön rajat pitävät sen nopeana kaikille.

                    

                                    

                        
                            Onko yhdistäminen turvallista?
                            
                        
                        
Kyllä. Kaikki työkalut ovat vain luku -työkaluja: palvelin palauttaa ainoastaan ALV-tietoja ja laskelmia. Se ei näe tiedostojasi eikä toimi puolestasi.

                    

                                    

                        
                            Kuinka ajantasaisia kannat ovat?
                            
                        
                        
Kannat perustuvat Euroopan komission tietoihin, ja ne päivitetään päivittäin. Jokainen tulos kertoo, milloin maan tiedot päivitettiin viimeksi.

                    

                                    

                        
                            Ovatko vastaukset veroneuvontaa?
                            
                        
                        
Eivät. Palvelin palauttaa viitekantoja. Oikea ALV-käsittely riippuu tavaroista tai palveluista ja asiakkaasta, joten tarkista tärkeät tapaukset veroneuvojalta tai kansalliselta veroviranomaiselta.