FastAPI NCM Attributes Tool

What is FastAPI NCM Attributes Tool?

FastAPI NCM Attributes Tool is a FastAPI-based API for retrieving information about NCM (Nomenclatura Comum do Mercosul) codes and their associated attributes. It provides RESTful endpoints and an MCP server integration for AI interaction, intended for developers needing to look up NCM code details.

How to use FastAPI NCM Attributes Tool?

The application is run with uvicorn main:app --reload --host 0.0.0.0 --port 8000. Use the endpoints GET /ncm/{ncm_code}/attributes to get attributes for a specific NCM code and GET /ncm/search?query={search_term} to search NCM codes by code or description. The MCP tool get_ncm_attributes_tool is available for AI integration.

Key features of FastAPI NCM Attributes Tool

• Search NCM codes by code or description.
• Retrieve all attributes for a specific NCM code with possible values.
• RESTful API endpoints with proper documentation.
• MCP server integration for AI interaction.
• Clean architecture with models, repositories, services, and schemas.
• PostgreSQL database with dedicated tables (ncm, ncm_attributes, attribute).

Use cases of FastAPI NCM Attributes Tool

• Look up attributes for a given NCM code for tariff classification.
• Integrate with an AI assistant to answer NCM-related queries.
• Automate batch retrieval of NCM attributes via HTTP API.

FAQ from FastAPI NCM Attributes Tool

What data does the tool use?

It uses a PostgreSQL database with tables ncm (codes and descriptions), ncm_attributes (associates codes to attributes), and attribute (attribute definitions).

How do I run the application?

Run uvicorn main:app --reload --host 0.0.0.0 --port 8000 from the project directory. The API documentation is then available at http://localhost:8000/docs.

What MCP tools are available?

The MCP tool get_ncm_attributes_tool is available to get attributes for an NCM code.

How can I access the API documentation?

Open http://localhost:8000/docs in your browser after starting the server.

What search functionality does the API provide?

The GET /ncm/search?query={search_term} endpoint searches for NCM codes by code or description.