parseapi-mcp 1.9.0 → 1.9.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +28 -0
- package/dist/{chunk-TAT7ORUC.js → chunk-YBY27EQG.js} +681 -8
- package/dist/http.js +1 -1
- package/dist/registry.js +1 -1
- package/dist/stdio.js +1 -1
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -249,3 +249,31 @@ Bank tools send original IBAN, routing and account strings in POST JSON bodies,
|
|
|
249
249
|
When US ACH returns a bank name, MCP includes a separate [routing reference attribution](https://parseapi.com/legal/attribution#routing-numbers) notice alongside the unchanged JSON result.
|
|
250
250
|
|
|
251
251
|
Vehicle lookups use `vin` as the input and response field. The `vin` tool remains available for compatibility.
|
|
252
|
+
|
|
253
|
+
## Emoji catalog additions
|
|
254
|
+
|
|
255
|
+
Resolve Unicode emoji or a named shortcode, search or browse a bounded catalog,
|
|
256
|
+
parse emoji positions in text, and convert between Unicode and a selected shortcode source.
|
|
257
|
+
The ordinary lookup remains four fields:
|
|
258
|
+
|
|
259
|
+
```http
|
|
260
|
+
GET /emoji/rocket
|
|
261
|
+
```
|
|
262
|
+
|
|
263
|
+
```json
|
|
264
|
+
{"emoji":"🚀","name":"Rocket","shortcodes":[":rocket:","rocket"],"category":"Travel & Places"}
|
|
265
|
+
```
|
|
266
|
+
|
|
267
|
+
Use `deep=true` for Unicode facts, keywords, tone families and available artwork.
|
|
268
|
+
Core values stay unchanged. Text parsing returns `emojis` with UTF-16 `positions`;
|
|
269
|
+
conversion returns `text` and unresolved tokens with positions and reasons.
|
|
270
|
+
|
|
271
|
+
The compact JSON catalog contains offline identity, qualification-form and
|
|
272
|
+
shortcode indexes. Request `profile=full` when artwork is needed and `lang` when
|
|
273
|
+
localized names and keywords are needed. `/emoji/metadata` carries dataset
|
|
274
|
+
coverage and shared source notices once. Artwork supports Google Noto, Twemoji
|
|
275
|
+
and OpenMoji, with real SVG/PNG availability and immutable first-party URLs.
|
|
276
|
+
A device's emoji font remains the ordinary display.
|
|
277
|
+
|
|
278
|
+
These additions are a local release candidate until the matching SDK and
|
|
279
|
+
backend are published. Existing lookup and search contracts are preserved.
|
|
@@ -834,6 +834,552 @@ var agent_catalog_default = {
|
|
|
834
834
|
help: "https://api.parseapi.com/version/2.0.0/time/help",
|
|
835
835
|
guide: "https://parseapi.com/docs/time"
|
|
836
836
|
}
|
|
837
|
+
},
|
|
838
|
+
emoji: {
|
|
839
|
+
operation: "emoji",
|
|
840
|
+
endpoint: "GET /emoji/{emoji}",
|
|
841
|
+
determines: [
|
|
842
|
+
"Canonical loaded Unicode emoji for a glyph, qualification form, codepoint sequence, exact name or shortcode",
|
|
843
|
+
"Optional encoding, keywords, variant-family facts and pinned artwork"
|
|
844
|
+
],
|
|
845
|
+
does_not_determine: [
|
|
846
|
+
"Native font availability on a device",
|
|
847
|
+
"Verified current Slack or Discord platform aliases",
|
|
848
|
+
"User meaning, sentiment or popularity"
|
|
849
|
+
],
|
|
850
|
+
required_context: [
|
|
851
|
+
"emoji: one complete glyph, codepoint sequence, exact name or shortcode",
|
|
852
|
+
"shortcode_source: optional cldr, github, slack or discord preset",
|
|
853
|
+
"deep=true only when reference detail is needed"
|
|
854
|
+
],
|
|
855
|
+
freshness: {
|
|
856
|
+
mode: "pinned_reference",
|
|
857
|
+
edition_field: "metadata.edition on catalog/metadata",
|
|
858
|
+
completeness_field: "metadata.completeness on catalog/metadata",
|
|
859
|
+
actual_age_status: "Not exposed; a pinned source revision does not establish observation age."
|
|
860
|
+
},
|
|
861
|
+
uncertainty: {
|
|
862
|
+
deep: {
|
|
863
|
+
omitted: "Not requested."
|
|
864
|
+
},
|
|
865
|
+
"deep.base": {
|
|
866
|
+
omitted: "No available loaded parent variant"
|
|
867
|
+
},
|
|
868
|
+
"deep.artwork": {
|
|
869
|
+
omitted_style: "Within an explicitly returned artwork object, the style has no verified asset for this glyph. Compact catalog records deliberately omit artwork."
|
|
870
|
+
},
|
|
871
|
+
shortcode_source: "Named presets have explicit provenance and compatibility caveats; missing or ambiguous aliases are not fabricated"
|
|
872
|
+
},
|
|
873
|
+
billing: {
|
|
874
|
+
pooled_requests_per_success: 1,
|
|
875
|
+
deep_extra_units: 0,
|
|
876
|
+
account_state: "unknown; account allowance, credentials, quotas and accepted terms are not evaluated"
|
|
877
|
+
},
|
|
878
|
+
access: {
|
|
879
|
+
api_key_required: true,
|
|
880
|
+
key_types: [
|
|
881
|
+
"secret",
|
|
882
|
+
"public",
|
|
883
|
+
"app"
|
|
884
|
+
],
|
|
885
|
+
key_fences: {
|
|
886
|
+
public: "Allowed browser origin required",
|
|
887
|
+
app: "Allowed X-App-Id required"
|
|
888
|
+
},
|
|
889
|
+
deep: {
|
|
890
|
+
entitlement: "Included reference detail on every plan"
|
|
891
|
+
},
|
|
892
|
+
effective_access_status: "Not checked; credential fences, account access and quotas still apply."
|
|
893
|
+
},
|
|
894
|
+
retry: {
|
|
895
|
+
client: "javascript_sdk_and_mcp",
|
|
896
|
+
default_retries: 2,
|
|
897
|
+
retry_http_statuses: [
|
|
898
|
+
429,
|
|
899
|
+
500,
|
|
900
|
+
502,
|
|
901
|
+
503,
|
|
902
|
+
504
|
|
903
|
+
],
|
|
904
|
+
retry_network_errors: true,
|
|
905
|
+
successful_unknown_retried: false,
|
|
906
|
+
guidance: "Do not retry to fill missing source facts or unsupported glyphs. Ordinary retries can consume additional pooled requests; rate and quota limits still apply."
|
|
907
|
+
},
|
|
908
|
+
docs: {
|
|
909
|
+
help: "https://api.parseapi.com/version/2.0.0/emoji/help",
|
|
910
|
+
guide: "https://parseapi.com/docs/emoji"
|
|
911
|
+
}
|
|
912
|
+
},
|
|
913
|
+
emoji_search: {
|
|
914
|
+
operation: "emoji_search",
|
|
915
|
+
endpoint: "GET /emoji?q={query}",
|
|
916
|
+
determines: [
|
|
917
|
+
"Ranked label, keyword and shortcode matches in the loaded inventory",
|
|
918
|
+
"Optional collection filters and translated display labels"
|
|
919
|
+
],
|
|
920
|
+
does_not_determine: [
|
|
921
|
+
"Natural-language understanding or global popularity",
|
|
922
|
+
"Complete translations merely from an accepted language"
|
|
923
|
+
],
|
|
924
|
+
required_context: [
|
|
925
|
+
"query: 1\u2013256 characters",
|
|
926
|
+
"limit: 1\u201350; offset: 0\u2013100000 when paging is required",
|
|
927
|
+
"Filtered or explicit-offset search returns total and next_offset; legacy plain-query envelope is preserved"
|
|
928
|
+
],
|
|
929
|
+
freshness: {
|
|
930
|
+
mode: "pinned_reference",
|
|
931
|
+
edition_field: "metadata.edition on catalog/metadata",
|
|
932
|
+
completeness_field: "metadata.completeness on catalog/metadata",
|
|
933
|
+
actual_age_status: "Not exposed; a pinned source revision does not establish observation age."
|
|
934
|
+
},
|
|
935
|
+
uncertainty: {
|
|
936
|
+
deep: {
|
|
937
|
+
omitted: "Not requested."
|
|
938
|
+
},
|
|
939
|
+
"deep.base": {
|
|
940
|
+
omitted: "No available loaded parent variant"
|
|
941
|
+
},
|
|
942
|
+
"deep.artwork": {
|
|
943
|
+
omitted_style: "Within an explicitly returned artwork object, the style has no verified asset for this glyph. Compact catalog records deliberately omit artwork."
|
|
944
|
+
},
|
|
945
|
+
shortcode_source: "Named presets have explicit provenance and compatibility caveats; missing or ambiguous aliases are not fabricated"
|
|
946
|
+
},
|
|
947
|
+
billing: {
|
|
948
|
+
pooled_requests_per_success: 1,
|
|
949
|
+
deep_extra_units: 0,
|
|
950
|
+
account_state: "unknown; account allowance, credentials, quotas and accepted terms are not evaluated"
|
|
951
|
+
},
|
|
952
|
+
access: {
|
|
953
|
+
api_key_required: true,
|
|
954
|
+
key_types: [
|
|
955
|
+
"secret",
|
|
956
|
+
"public",
|
|
957
|
+
"app"
|
|
958
|
+
],
|
|
959
|
+
key_fences: {
|
|
960
|
+
public: "Allowed browser origin required",
|
|
961
|
+
app: "Allowed X-App-Id required"
|
|
962
|
+
},
|
|
963
|
+
deep: {
|
|
964
|
+
entitlement: "Included reference detail on every plan"
|
|
965
|
+
},
|
|
966
|
+
effective_access_status: "Not checked; credential fences, account access and quotas still apply."
|
|
967
|
+
},
|
|
968
|
+
retry: {
|
|
969
|
+
client: "javascript_sdk_and_mcp",
|
|
970
|
+
default_retries: 2,
|
|
971
|
+
retry_http_statuses: [
|
|
972
|
+
429,
|
|
973
|
+
500,
|
|
974
|
+
502,
|
|
975
|
+
503,
|
|
976
|
+
504
|
|
977
|
+
],
|
|
978
|
+
retry_network_errors: true,
|
|
979
|
+
successful_unknown_retried: false,
|
|
980
|
+
guidance: "Do not retry to fill missing source facts or unsupported glyphs. Ordinary retries can consume additional pooled requests; rate and quota limits still apply."
|
|
981
|
+
},
|
|
982
|
+
docs: {
|
|
983
|
+
help: "https://api.parseapi.com/version/2.0.0/emoji/help",
|
|
984
|
+
guide: "https://parseapi.com/docs/emoji"
|
|
985
|
+
}
|
|
986
|
+
},
|
|
987
|
+
emoji_browse: {
|
|
988
|
+
operation: "emoji_browse",
|
|
989
|
+
endpoint: "GET /emoji",
|
|
990
|
+
determines: [
|
|
991
|
+
"Catalog-order records in the selected category, subcategory, release, tone scope",
|
|
992
|
+
"Predictable total and next_offset pagination"
|
|
993
|
+
],
|
|
994
|
+
does_not_determine: [
|
|
995
|
+
"A personalized or popularity-ranked picker"
|
|
996
|
+
],
|
|
997
|
+
required_context: [
|
|
998
|
+
"Omit q to browse",
|
|
999
|
+
"limit: 1\u201350; offset: 0\u2013100000",
|
|
1000
|
+
"Stop when next_offset is null"
|
|
1001
|
+
],
|
|
1002
|
+
freshness: {
|
|
1003
|
+
mode: "pinned_reference",
|
|
1004
|
+
edition_field: "metadata.edition on catalog/metadata",
|
|
1005
|
+
completeness_field: "metadata.completeness on catalog/metadata",
|
|
1006
|
+
actual_age_status: "Not exposed; a pinned source revision does not establish observation age."
|
|
1007
|
+
},
|
|
1008
|
+
uncertainty: {
|
|
1009
|
+
deep: {
|
|
1010
|
+
omitted: "Not requested."
|
|
1011
|
+
},
|
|
1012
|
+
"deep.base": {
|
|
1013
|
+
omitted: "No available loaded parent variant"
|
|
1014
|
+
},
|
|
1015
|
+
"deep.artwork": {
|
|
1016
|
+
omitted_style: "Within an explicitly returned artwork object, the style has no verified asset for this glyph. Compact catalog records deliberately omit artwork."
|
|
1017
|
+
},
|
|
1018
|
+
shortcode_source: "Named presets have explicit provenance and compatibility caveats; missing or ambiguous aliases are not fabricated"
|
|
1019
|
+
},
|
|
1020
|
+
billing: {
|
|
1021
|
+
pooled_requests_per_success: 1,
|
|
1022
|
+
deep_extra_units: 0,
|
|
1023
|
+
account_state: "unknown; account allowance, credentials, quotas and accepted terms are not evaluated"
|
|
1024
|
+
},
|
|
1025
|
+
access: {
|
|
1026
|
+
api_key_required: true,
|
|
1027
|
+
key_types: [
|
|
1028
|
+
"secret",
|
|
1029
|
+
"public",
|
|
1030
|
+
"app"
|
|
1031
|
+
],
|
|
1032
|
+
key_fences: {
|
|
1033
|
+
public: "Allowed browser origin required",
|
|
1034
|
+
app: "Allowed X-App-Id required"
|
|
1035
|
+
},
|
|
1036
|
+
deep: {
|
|
1037
|
+
entitlement: "Included reference detail on every plan"
|
|
1038
|
+
},
|
|
1039
|
+
effective_access_status: "Not checked; credential fences, account access and quotas still apply."
|
|
1040
|
+
},
|
|
1041
|
+
retry: {
|
|
1042
|
+
client: "javascript_sdk_and_mcp",
|
|
1043
|
+
default_retries: 2,
|
|
1044
|
+
retry_http_statuses: [
|
|
1045
|
+
429,
|
|
1046
|
+
500,
|
|
1047
|
+
502,
|
|
1048
|
+
503,
|
|
1049
|
+
504
|
|
1050
|
+
],
|
|
1051
|
+
retry_network_errors: true,
|
|
1052
|
+
successful_unknown_retried: false,
|
|
1053
|
+
guidance: "Do not retry to fill missing source facts or unsupported glyphs. Ordinary retries can consume additional pooled requests; rate and quota limits still apply."
|
|
1054
|
+
},
|
|
1055
|
+
docs: {
|
|
1056
|
+
help: "https://api.parseapi.com/version/2.0.0/emoji/help",
|
|
1057
|
+
guide: "https://parseapi.com/docs/emoji"
|
|
1058
|
+
}
|
|
1059
|
+
},
|
|
1060
|
+
emoji_categories: {
|
|
1061
|
+
operation: "emoji_categories",
|
|
1062
|
+
endpoint: "GET /emoji/categories",
|
|
1063
|
+
determines: [
|
|
1064
|
+
"Loaded category names and subcategory taxonomy"
|
|
1065
|
+
],
|
|
1066
|
+
does_not_determine: [
|
|
1067
|
+
"Localized category labels",
|
|
1068
|
+
"Categories outside the loaded inventory"
|
|
1069
|
+
],
|
|
1070
|
+
required_context: [
|
|
1071
|
+
"No required input; category and subcategory filters accept the returned taxonomy"
|
|
1072
|
+
],
|
|
1073
|
+
freshness: {
|
|
1074
|
+
mode: "pinned_reference",
|
|
1075
|
+
edition_field: "metadata.edition on catalog/metadata",
|
|
1076
|
+
completeness_field: "metadata.completeness on catalog/metadata",
|
|
1077
|
+
actual_age_status: "Not exposed; a pinned source revision does not establish observation age."
|
|
1078
|
+
},
|
|
1079
|
+
billing: {
|
|
1080
|
+
pooled_requests_per_success: 1,
|
|
1081
|
+
account_state: "unknown; account allowance, credentials, quotas and accepted terms are not evaluated"
|
|
1082
|
+
},
|
|
1083
|
+
access: {
|
|
1084
|
+
api_key_required: true,
|
|
1085
|
+
key_types: [
|
|
1086
|
+
"secret",
|
|
1087
|
+
"public",
|
|
1088
|
+
"app"
|
|
1089
|
+
],
|
|
1090
|
+
key_fences: {
|
|
1091
|
+
public: "Allowed browser origin required",
|
|
1092
|
+
app: "Allowed X-App-Id required"
|
|
1093
|
+
},
|
|
1094
|
+
effective_access_status: "Not checked; credential fences, account access and quotas still apply."
|
|
1095
|
+
},
|
|
1096
|
+
retry: {
|
|
1097
|
+
client: "javascript_sdk_and_mcp",
|
|
1098
|
+
default_retries: 2,
|
|
1099
|
+
retry_http_statuses: [
|
|
1100
|
+
429,
|
|
1101
|
+
500,
|
|
1102
|
+
502,
|
|
1103
|
+
503,
|
|
1104
|
+
504
|
|
1105
|
+
],
|
|
1106
|
+
retry_network_errors: true,
|
|
1107
|
+
successful_unknown_retried: false,
|
|
1108
|
+
guidance: "Do not retry to fill missing source facts or unsupported glyphs. Ordinary retries can consume additional pooled requests; rate and quota limits still apply."
|
|
1109
|
+
},
|
|
1110
|
+
docs: {
|
|
1111
|
+
help: "https://api.parseapi.com/version/2.0.0/emoji/help",
|
|
1112
|
+
guide: "https://parseapi.com/docs/emoji"
|
|
1113
|
+
}
|
|
1114
|
+
},
|
|
1115
|
+
emoji_metadata: {
|
|
1116
|
+
operation: "emoji_metadata",
|
|
1117
|
+
endpoint: "GET /emoji/metadata",
|
|
1118
|
+
determines: [
|
|
1119
|
+
"Loaded inventory total, source edition, official-source completeness and provenance",
|
|
1120
|
+
"Loaded artwork coverage, source licenses and notices"
|
|
1121
|
+
],
|
|
1122
|
+
does_not_determine: [
|
|
1123
|
+
"A guarantee that every upstream artwork source supports the newest Unicode release",
|
|
1124
|
+
"Account entitlement or a monetary quote"
|
|
1125
|
+
],
|
|
1126
|
+
required_context: [
|
|
1127
|
+
"No required input",
|
|
1128
|
+
"The API and MCP return the same metadata; data notices are embedded and artwork notice files are linked"
|
|
1129
|
+
],
|
|
1130
|
+
freshness: {
|
|
1131
|
+
mode: "pinned_reference",
|
|
1132
|
+
edition_field: "metadata.edition on catalog/metadata",
|
|
1133
|
+
completeness_field: "metadata.completeness on catalog/metadata",
|
|
1134
|
+
actual_age_status: "Not exposed; a pinned source revision does not establish observation age."
|
|
1135
|
+
},
|
|
1136
|
+
billing: {
|
|
1137
|
+
pooled_requests_per_success: 1,
|
|
1138
|
+
account_state: "unknown; account allowance, credentials, quotas and accepted terms are not evaluated"
|
|
1139
|
+
},
|
|
1140
|
+
access: {
|
|
1141
|
+
api_key_required: true,
|
|
1142
|
+
key_types: [
|
|
1143
|
+
"secret",
|
|
1144
|
+
"public",
|
|
1145
|
+
"app"
|
|
1146
|
+
],
|
|
1147
|
+
key_fences: {
|
|
1148
|
+
public: "Allowed browser origin required",
|
|
1149
|
+
app: "Allowed X-App-Id required"
|
|
1150
|
+
},
|
|
1151
|
+
effective_access_status: "Not checked; credential fences, account access and quotas still apply."
|
|
1152
|
+
},
|
|
1153
|
+
retry: {
|
|
1154
|
+
client: "javascript_sdk_and_mcp",
|
|
1155
|
+
default_retries: 2,
|
|
1156
|
+
retry_http_statuses: [
|
|
1157
|
+
429,
|
|
1158
|
+
500,
|
|
1159
|
+
502,
|
|
1160
|
+
503,
|
|
1161
|
+
504
|
|
1162
|
+
],
|
|
1163
|
+
retry_network_errors: true,
|
|
1164
|
+
successful_unknown_retried: false,
|
|
1165
|
+
guidance: "Do not retry to fill missing source facts or unsupported glyphs. Ordinary retries can consume additional pooled requests; rate and quota limits still apply."
|
|
1166
|
+
},
|
|
1167
|
+
docs: {
|
|
1168
|
+
help: "https://api.parseapi.com/version/2.0.0/emoji/help",
|
|
1169
|
+
guide: "https://parseapi.com/docs/emoji"
|
|
1170
|
+
}
|
|
1171
|
+
},
|
|
1172
|
+
emoji_catalog: {
|
|
1173
|
+
operation: "emoji_catalog",
|
|
1174
|
+
endpoint: "GET /emoji/catalog",
|
|
1175
|
+
determines: [
|
|
1176
|
+
"Downloadable JSON records within explicit inventory scope",
|
|
1177
|
+
"JSON qualification maps, source aliases, legacy winners and native search facts for offline clients"
|
|
1178
|
+
],
|
|
1179
|
+
does_not_determine: [
|
|
1180
|
+
"A full catalog embedded in MCP model context",
|
|
1181
|
+
"A translated label for every row merely from a supported locale"
|
|
1182
|
+
],
|
|
1183
|
+
required_context: [
|
|
1184
|
+
"JSON compact profile by default; profile=full includes artwork and encoding detail",
|
|
1185
|
+
"Optional filters and language; download_url requires an authenticated HTTP request",
|
|
1186
|
+
"Compact is the default; request profile=full for artwork. MCP metadata describes the complete inventory; the downloaded file supplies the selected total and scope."
|
|
1187
|
+
],
|
|
1188
|
+
freshness: {
|
|
1189
|
+
mode: "pinned_reference",
|
|
1190
|
+
edition_field: "metadata.edition on catalog/metadata",
|
|
1191
|
+
completeness_field: "metadata.completeness on catalog/metadata",
|
|
1192
|
+
actual_age_status: "Not exposed; a pinned source revision does not establish observation age."
|
|
1193
|
+
},
|
|
1194
|
+
uncertainty: {
|
|
1195
|
+
deep: {
|
|
1196
|
+
omitted: "Not requested."
|
|
1197
|
+
},
|
|
1198
|
+
"deep.base": {
|
|
1199
|
+
omitted: "No available loaded parent variant"
|
|
1200
|
+
},
|
|
1201
|
+
"deep.artwork": {
|
|
1202
|
+
omitted_style: "Within an explicitly returned artwork object, the style has no verified asset for this glyph. Compact catalog records deliberately omit artwork."
|
|
1203
|
+
},
|
|
1204
|
+
shortcode_source: "Named presets have explicit provenance and compatibility caveats; missing or ambiguous aliases are not fabricated"
|
|
1205
|
+
},
|
|
1206
|
+
billing: {
|
|
1207
|
+
pooled_requests_per_success: 1,
|
|
1208
|
+
deep_extra_units: 0,
|
|
1209
|
+
account_state: "unknown; account allowance, credentials, quotas and accepted terms are not evaluated",
|
|
1210
|
+
mcp_pooled_requests_per_success: 1,
|
|
1211
|
+
mcp_behavior: "One metadata read. Following download_url performs one separate pooled request; local operations use no pooled requests.",
|
|
1212
|
+
offline_operations_extra_units: 0
|
|
1213
|
+
},
|
|
1214
|
+
access: {
|
|
1215
|
+
api_key_required: true,
|
|
1216
|
+
key_types: [
|
|
1217
|
+
"secret",
|
|
1218
|
+
"public",
|
|
1219
|
+
"app"
|
|
1220
|
+
],
|
|
1221
|
+
key_fences: {
|
|
1222
|
+
public: "Allowed browser origin required",
|
|
1223
|
+
app: "Allowed X-App-Id required"
|
|
1224
|
+
},
|
|
1225
|
+
deep: {
|
|
1226
|
+
entitlement: "Included reference detail on every plan"
|
|
1227
|
+
},
|
|
1228
|
+
effective_access_status: "Not checked; credential fences, account access and quotas still apply."
|
|
1229
|
+
},
|
|
1230
|
+
retry: {
|
|
1231
|
+
client: "javascript_sdk_and_mcp",
|
|
1232
|
+
default_retries: 2,
|
|
1233
|
+
retry_http_statuses: [
|
|
1234
|
+
429,
|
|
1235
|
+
500,
|
|
1236
|
+
502,
|
|
1237
|
+
503,
|
|
1238
|
+
504
|
|
1239
|
+
],
|
|
1240
|
+
retry_network_errors: true,
|
|
1241
|
+
successful_unknown_retried: false,
|
|
1242
|
+
guidance: "Do not retry to fill missing source facts or unsupported glyphs. Ordinary retries can consume additional pooled requests; rate and quota limits still apply."
|
|
1243
|
+
},
|
|
1244
|
+
docs: {
|
|
1245
|
+
help: "https://api.parseapi.com/version/2.0.0/emoji/help",
|
|
1246
|
+
guide: "https://parseapi.com/docs/emoji"
|
|
1247
|
+
}
|
|
1248
|
+
},
|
|
1249
|
+
emoji_parse: {
|
|
1250
|
+
operation: "emoji_parse",
|
|
1251
|
+
endpoint: "POST /emoji/parse",
|
|
1252
|
+
determines: [
|
|
1253
|
+
"Complete loaded Unicode graphemes, grouped in first-occurrence order",
|
|
1254
|
+
"Every occurrence as original UTF-16 positions with exclusive end"
|
|
1255
|
+
],
|
|
1256
|
+
does_not_determine: [
|
|
1257
|
+
"Shortcode decoding",
|
|
1258
|
+
"Partial matches inside unsupported joined graphemes",
|
|
1259
|
+
"Sentiment, intent or native font support"
|
|
1260
|
+
],
|
|
1261
|
+
required_context: [
|
|
1262
|
+
"text: JSON body string, maximum 16000 UTF-16 code units",
|
|
1263
|
+
"Positions use UTF-16 code units and exclusive end; they are not codepoint or byte offsets"
|
|
1264
|
+
],
|
|
1265
|
+
freshness: {
|
|
1266
|
+
mode: "pinned_reference",
|
|
1267
|
+
edition_field: "metadata.edition on catalog/metadata",
|
|
1268
|
+
completeness_field: "metadata.completeness on catalog/metadata",
|
|
1269
|
+
actual_age_status: "Not exposed; a pinned source revision does not establish observation age."
|
|
1270
|
+
},
|
|
1271
|
+
uncertainty: {
|
|
1272
|
+
deep: {
|
|
1273
|
+
omitted: "Not requested."
|
|
1274
|
+
},
|
|
1275
|
+
"deep.base": {
|
|
1276
|
+
omitted: "No available loaded parent variant"
|
|
1277
|
+
},
|
|
1278
|
+
"deep.artwork": {
|
|
1279
|
+
omitted_style: "Within an explicitly returned artwork object, the style has no verified asset for this glyph. Compact catalog records deliberately omit artwork."
|
|
1280
|
+
}
|
|
1281
|
+
},
|
|
1282
|
+
billing: {
|
|
1283
|
+
pooled_requests_per_success: 1,
|
|
1284
|
+
deep_extra_units: 0,
|
|
1285
|
+
account_state: "unknown; account allowance, credentials, quotas and accepted terms are not evaluated"
|
|
1286
|
+
},
|
|
1287
|
+
access: {
|
|
1288
|
+
api_key_required: true,
|
|
1289
|
+
key_types: [
|
|
1290
|
+
"secret",
|
|
1291
|
+
"public",
|
|
1292
|
+
"app"
|
|
1293
|
+
],
|
|
1294
|
+
key_fences: {
|
|
1295
|
+
public: "Allowed browser origin required",
|
|
1296
|
+
app: "Allowed X-App-Id required"
|
|
1297
|
+
},
|
|
1298
|
+
deep: {
|
|
1299
|
+
entitlement: "Included reference detail on every plan"
|
|
1300
|
+
},
|
|
1301
|
+
effective_access_status: "Not checked; credential fences, account access and quotas still apply."
|
|
1302
|
+
},
|
|
1303
|
+
retry: {
|
|
1304
|
+
client: "javascript_sdk_and_mcp",
|
|
1305
|
+
default_retries: 2,
|
|
1306
|
+
retry_http_statuses: [
|
|
1307
|
+
429,
|
|
1308
|
+
500,
|
|
1309
|
+
502,
|
|
1310
|
+
503,
|
|
1311
|
+
504
|
|
1312
|
+
],
|
|
1313
|
+
retry_network_errors: true,
|
|
1314
|
+
successful_unknown_retried: false,
|
|
1315
|
+
guidance: "Do not retry to fill missing source facts or unsupported glyphs. Ordinary retries can consume additional pooled requests; rate and quota limits still apply."
|
|
1316
|
+
},
|
|
1317
|
+
docs: {
|
|
1318
|
+
help: "https://api.parseapi.com/version/2.0.0/emoji/help",
|
|
1319
|
+
guide: "https://parseapi.com/docs/emoji"
|
|
1320
|
+
}
|
|
1321
|
+
},
|
|
1322
|
+
emoji_convert: {
|
|
1323
|
+
operation: "emoji_convert",
|
|
1324
|
+
endpoint: "POST /emoji/convert",
|
|
1325
|
+
determines: [
|
|
1326
|
+
"Converted text using an explicitly named shortcode preset",
|
|
1327
|
+
"Unresolved tokens with original UTF-16 offsets and specific reasons"
|
|
1328
|
+
],
|
|
1329
|
+
does_not_determine: [
|
|
1330
|
+
"Invented aliases for unsupported releases",
|
|
1331
|
+
"Replacement of unknown or ambiguous literal input"
|
|
1332
|
+
],
|
|
1333
|
+
required_context: [
|
|
1334
|
+
"text: JSON body string, maximum 16000 UTF-16 code units",
|
|
1335
|
+
"direction: to_shortcodes or to_emoji",
|
|
1336
|
+
"shortcode_source: required cldr, github, slack or discord"
|
|
1337
|
+
],
|
|
1338
|
+
freshness: {
|
|
1339
|
+
mode: "pinned_reference",
|
|
1340
|
+
edition_field: "metadata.edition on catalog/metadata",
|
|
1341
|
+
completeness_field: "metadata.completeness on catalog/metadata",
|
|
1342
|
+
actual_age_status: "Not exposed; a pinned source revision does not establish observation age."
|
|
1343
|
+
},
|
|
1344
|
+
uncertainty: {
|
|
1345
|
+
shortcode_source: "Named presets have explicit provenance and compatibility caveats; missing or ambiguous aliases are not fabricated",
|
|
1346
|
+
unresolved: "Unknown, ambiguous or unavailable tokens remain literal; each unresolved token includes its reason and original UTF-16 positions."
|
|
1347
|
+
},
|
|
1348
|
+
billing: {
|
|
1349
|
+
pooled_requests_per_success: 1,
|
|
1350
|
+
account_state: "unknown; account allowance, credentials, quotas and accepted terms are not evaluated"
|
|
1351
|
+
},
|
|
1352
|
+
access: {
|
|
1353
|
+
api_key_required: true,
|
|
1354
|
+
key_types: [
|
|
1355
|
+
"secret",
|
|
1356
|
+
"public",
|
|
1357
|
+
"app"
|
|
1358
|
+
],
|
|
1359
|
+
key_fences: {
|
|
1360
|
+
public: "Allowed browser origin required",
|
|
1361
|
+
app: "Allowed X-App-Id required"
|
|
1362
|
+
},
|
|
1363
|
+
effective_access_status: "Not checked; credential fences, account access and quotas still apply."
|
|
1364
|
+
},
|
|
1365
|
+
retry: {
|
|
1366
|
+
client: "javascript_sdk_and_mcp",
|
|
1367
|
+
default_retries: 2,
|
|
1368
|
+
retry_http_statuses: [
|
|
1369
|
+
429,
|
|
1370
|
+
500,
|
|
1371
|
+
502,
|
|
1372
|
+
503,
|
|
1373
|
+
504
|
|
1374
|
+
],
|
|
1375
|
+
retry_network_errors: true,
|
|
1376
|
+
successful_unknown_retried: false,
|
|
1377
|
+
guidance: "Do not retry to fill missing source facts or unsupported glyphs. Ordinary retries can consume additional pooled requests; rate and quota limits still apply."
|
|
1378
|
+
},
|
|
1379
|
+
docs: {
|
|
1380
|
+
help: "https://api.parseapi.com/version/2.0.0/emoji/help",
|
|
1381
|
+
guide: "https://parseapi.com/docs/emoji"
|
|
1382
|
+
}
|
|
837
1383
|
}
|
|
838
1384
|
}
|
|
839
1385
|
};
|
|
@@ -1006,8 +1552,74 @@ function registerTasks(server, client, transport) {
|
|
|
1006
1552
|
}, ({ task_id, request_id, ...input }, context) => call(() => client.task.lookup(task_id, input, request_id, { signal: context.mcpReq.signal })));
|
|
1007
1553
|
}
|
|
1008
1554
|
|
|
1555
|
+
// package.json
|
|
1556
|
+
var package_default = {
|
|
1557
|
+
name: "parseapi-mcp",
|
|
1558
|
+
version: "1.9.2",
|
|
1559
|
+
mcpName: "com.parseapi/mcp",
|
|
1560
|
+
description: "Official ParseAPI MCP server. Look up places, addresses, company numbers, email, phone, weather, dates and more.",
|
|
1561
|
+
keywords: [
|
|
1562
|
+
"parseapi",
|
|
1563
|
+
"mcp",
|
|
1564
|
+
"model context protocol",
|
|
1565
|
+
"agents",
|
|
1566
|
+
"geolocation",
|
|
1567
|
+
"email validation",
|
|
1568
|
+
"weather"
|
|
1569
|
+
],
|
|
1570
|
+
license: "MIT",
|
|
1571
|
+
author: "ParseAPI <hello@parseapi.com> (https://parseapi.com)",
|
|
1572
|
+
homepage: "https://parseapi.com",
|
|
1573
|
+
repository: {
|
|
1574
|
+
type: "git",
|
|
1575
|
+
url: "git+https://github.com/parseapi/mcp.git"
|
|
1576
|
+
},
|
|
1577
|
+
bugs: {
|
|
1578
|
+
url: "https://github.com/parseapi/mcp/issues"
|
|
1579
|
+
},
|
|
1580
|
+
type: "module",
|
|
1581
|
+
bin: {
|
|
1582
|
+
"parseapi-mcp": "./dist/stdio.js"
|
|
1583
|
+
},
|
|
1584
|
+
exports: {
|
|
1585
|
+
".": "./dist/registry.js",
|
|
1586
|
+
"./http": "./dist/http.js"
|
|
1587
|
+
},
|
|
1588
|
+
files: [
|
|
1589
|
+
"dist"
|
|
1590
|
+
],
|
|
1591
|
+
engines: {
|
|
1592
|
+
node: ">=20"
|
|
1593
|
+
},
|
|
1594
|
+
scripts: {
|
|
1595
|
+
"catalog:sync": "node scripts/sync-agent-catalog.mjs",
|
|
1596
|
+
"catalog:check": "node scripts/sync-agent-catalog.mjs --check",
|
|
1597
|
+
"eval:agents": "npm run build && node eval/run.mjs --self-test",
|
|
1598
|
+
build: "tsup",
|
|
1599
|
+
typecheck: "tsc --noEmit",
|
|
1600
|
+
smoke: "npm run build && node smoke/smoke.mjs",
|
|
1601
|
+
serve: "npm run build && node dist/http.js",
|
|
1602
|
+
test: "npm run build && node --test test/*.test.mjs",
|
|
1603
|
+
prepublishOnly: "npm run typecheck && npm test"
|
|
1604
|
+
},
|
|
1605
|
+
dependencies: {
|
|
1606
|
+
"@modelcontextprotocol/node": "^2.0.0",
|
|
1607
|
+
"@modelcontextprotocol/server": "^2.0.0",
|
|
1608
|
+
"@parseapi/sdk": "^1.10.1",
|
|
1609
|
+
zod: "^4.0.0"
|
|
1610
|
+
},
|
|
1611
|
+
devDependencies: {
|
|
1612
|
+
"@types/node": "^22.10.0",
|
|
1613
|
+
tsup: "^8.3.5",
|
|
1614
|
+
typescript: "^5.7.0"
|
|
1615
|
+
},
|
|
1616
|
+
overrides: {
|
|
1617
|
+
esbuild: "0.27.2"
|
|
1618
|
+
}
|
|
1619
|
+
};
|
|
1620
|
+
|
|
1009
1621
|
// src/registry.ts
|
|
1010
|
-
var VERSION =
|
|
1622
|
+
var VERSION = package_default.version;
|
|
1011
1623
|
var API_VERSION = "2.0.0";
|
|
1012
1624
|
var US_ROUTING_NOTICE = "Routing reference attribution: https://parseapi.com/legal/attribution#routing-numbers";
|
|
1013
1625
|
var AU_POSTAL_NOTICE = "Incorporates or developed using G-NAF \xA9 Geoscape Australia licensed by the Commonwealth of Australia under the Open Geo-coded National Address File (G-NAF) End User Licence Agreement. Geographic choices are not mailing-address verification. Source, adaptations and licence: https://parseapi.com/legal/attribution#postal-au";
|
|
@@ -1068,9 +1680,22 @@ var languageTools = /* @__PURE__ */ new Set([
|
|
|
1068
1680
|
"measure_units",
|
|
1069
1681
|
"emoji",
|
|
1070
1682
|
"emoji_search",
|
|
1683
|
+
"emoji_browse",
|
|
1684
|
+
"emoji_parse",
|
|
1685
|
+
"emoji_catalog",
|
|
1071
1686
|
"point"
|
|
1072
1687
|
]);
|
|
1073
1688
|
var displayLanguage = z4.string().min(2).max(64).optional().describe("Optional display language, such as fr or zh-Hant. IDs, numeric values and input parsing stay unchanged.");
|
|
1689
|
+
var emojiFilters = {
|
|
1690
|
+
limit: z4.number().int().min(1).max(50).optional().describe("Maximum results per page."),
|
|
1691
|
+
category: z4.string().optional().describe("Category from emoji_categories."),
|
|
1692
|
+
subcategory: z4.string().optional().describe("Subcategory from emoji_categories."),
|
|
1693
|
+
version: z4.string().optional().describe("Exact Emoji release version, such as 17.0."),
|
|
1694
|
+
max_version: z4.string().optional().describe("Latest Emoji release to include, such as 16.0."),
|
|
1695
|
+
include_skin_tones: z4.boolean().optional().describe("Include skin-tone variants. Explicit false excludes them."),
|
|
1696
|
+
offset: z4.number().int().min(0).max(1e5).optional().describe("Page offset. Reuse next_offset with the same filters."),
|
|
1697
|
+
deep: deep.describe("Include optional reference detail on every plan.")
|
|
1698
|
+
};
|
|
1074
1699
|
function buildServer(key, transport, options = {}) {
|
|
1075
1700
|
const mode = options.mode ?? "full";
|
|
1076
1701
|
if (mode !== "full" && mode !== "compact") throw new Error("Unknown MCP catalog mode");
|
|
@@ -1817,19 +2442,67 @@ function buildServer(key, transport, options = {}) {
|
|
|
1817
2442
|
);
|
|
1818
2443
|
tool(
|
|
1819
2444
|
"emoji",
|
|
1820
|
-
|
|
1821
|
-
{ emoji: z4.string().describe("Emoji
|
|
1822
|
-
(c, a, request) => c.emoji(a.emoji, { ...request, deep: a.deep })
|
|
2445
|
+
'Resolve an emoji character, shortcode, name or codepoint sequence. Deep adds encoding, keywords, tone relationships and artwork on every plan. Artwork is keyed by style: deep.artwork.openmoji.svg and deep.artwork.openmoji.png["72"].',
|
|
2446
|
+
{ emoji: z4.string().describe("Emoji input, e.g. rocket, :rocket:, \u{1F680} or U+1F680"), shortcode_source: z4.enum(["cldr", "github", "slack", "discord"]).optional().describe("Resolve the shortcode within this source."), deep: deep.describe("Include optional detail on every plan.") },
|
|
2447
|
+
(c, a, request) => c.emoji(a.emoji, { ...request, deep: a.deep, shortcodeSource: a.shortcode_source })
|
|
1823
2448
|
);
|
|
1824
2449
|
tool(
|
|
1825
2450
|
"emoji_search",
|
|
1826
|
-
"Search emoji by keyword.
|
|
2451
|
+
"Search emoji by keyword with optional catalog filters. Explicit offset or filters return total and next_offset. Deep belongs to each result.",
|
|
1827
2452
|
{
|
|
1828
2453
|
query: z4.string().describe("Search keyword, e.g. fire"),
|
|
1829
|
-
|
|
1830
|
-
|
|
2454
|
+
...emojiFilters
|
|
2455
|
+
},
|
|
2456
|
+
(c, a, request) => c.emoji.search(a.query, { ...request, ...a, maxVersion: a.max_version, includeSkinTones: a.include_skin_tones })
|
|
2457
|
+
);
|
|
2458
|
+
tool(
|
|
2459
|
+
"emoji_browse",
|
|
2460
|
+
"Browse the emoji catalog by category, subcategory or Emoji release. Returns total and next_offset for pagination; omit a search query.",
|
|
2461
|
+
emojiFilters,
|
|
2462
|
+
(c, a, request) => c.emoji.browse({ ...request, ...a, maxVersion: a.max_version, includeSkinTones: a.include_skin_tones })
|
|
2463
|
+
);
|
|
2464
|
+
tool(
|
|
2465
|
+
"emoji_metadata",
|
|
2466
|
+
"Get actual emoji inventory total, content edition, official-source completeness, provenance and artwork coverage. Artwork notice files are linked; data notices travel with the snapshot. One pooled read.",
|
|
2467
|
+
{},
|
|
2468
|
+
async (c, _a, request) => c.emoji.metadata(request)
|
|
2469
|
+
);
|
|
2470
|
+
tool(
|
|
2471
|
+
"emoji_catalog",
|
|
2472
|
+
"Get a JSON catalog download URL and current coverage. One pooled metadata read; the download is a separate request with your API key. The full snapshot stays out of model context.",
|
|
2473
|
+
{
|
|
2474
|
+
category: emojiFilters.category,
|
|
2475
|
+
subcategory: emojiFilters.subcategory,
|
|
2476
|
+
version: emojiFilters.version,
|
|
2477
|
+
max_version: emojiFilters.max_version,
|
|
2478
|
+
include_skin_tones: emojiFilters.include_skin_tones,
|
|
2479
|
+
profile: z4.enum(["full", "compact"]).optional().describe("JSON download profile. Compact retains offline lookup, search and parse facts while omitting bulky artwork details.")
|
|
1831
2480
|
},
|
|
1832
|
-
(c, a, request) =>
|
|
2481
|
+
async (c, a, request) => {
|
|
2482
|
+
const metadata = await c.emoji.metadata(request);
|
|
2483
|
+
const url = new URL("https://api.parseapi.com/emoji/catalog");
|
|
2484
|
+
for (const [key2, value] of Object.entries({ category: a.category, subcategory: a.subcategory, version: a.version, max_version: a.max_version, include_skin_tones: a.include_skin_tones, lang: request.lang })) if (value !== void 0) url.searchParams.set(key2, String(value));
|
|
2485
|
+
if (a.profile) url.searchParams.set("profile", a.profile);
|
|
2486
|
+
return { metadata, download_url: url.href };
|
|
2487
|
+
}
|
|
2488
|
+
);
|
|
2489
|
+
tool(
|
|
2490
|
+
"emoji_categories",
|
|
2491
|
+
"List emoji categories and their subcategories for search and browsing filters.",
|
|
2492
|
+
{},
|
|
2493
|
+
(c, _a, request) => c.emoji.categories(request)
|
|
2494
|
+
);
|
|
2495
|
+
tool(
|
|
2496
|
+
"emoji_parse",
|
|
2497
|
+
"Extract complete Unicode emoji sequences from text. Results group repeated emoji in first-occurrence order, and positions use UTF-16 code units with an exclusive end. Text is sent in the POST body.",
|
|
2498
|
+
{ text: z4.string().max(16e3).describe("Text to inspect for native Unicode emoji, up to 16000 UTF-16 code units."), deep: deep.describe("Include optional reference detail inside each result.") },
|
|
2499
|
+
(c, a, request) => c.emoji.parse(a.text, { ...request, deep: a.deep })
|
|
2500
|
+
);
|
|
2501
|
+
tool(
|
|
2502
|
+
"emoji_convert",
|
|
2503
|
+
"Convert Unicode emoji to a named shortcode preset or decode that preset. Unknown, unavailable and ambiguous inputs remain literal with reasons and original UTF-16 offsets. Text is sent in the POST body.",
|
|
2504
|
+
{ text: z4.string().max(16e3), direction: z4.enum(["to_shortcodes", "to_emoji"]), shortcode_source: z4.enum(["cldr", "github", "slack", "discord"]) },
|
|
2505
|
+
(c, a, request) => c.emoji.convert(a.text, { ...request, direction: a.direction, shortcodeSource: a.shortcode_source })
|
|
1833
2506
|
);
|
|
1834
2507
|
registerDiscovery(server, operations, mode, API_VERSION);
|
|
1835
2508
|
registerPreflight(server, parse, transport);
|
package/dist/http.js
CHANGED
package/dist/registry.js
CHANGED
package/dist/stdio.js
CHANGED
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "parseapi-mcp",
|
|
3
|
-
"version": "1.9.
|
|
3
|
+
"version": "1.9.2",
|
|
4
4
|
"mcpName": "com.parseapi/mcp",
|
|
5
5
|
"description": "Official ParseAPI MCP server. Look up places, addresses, company numbers, email, phone, weather, dates and more.",
|
|
6
6
|
"keywords": [
|
|
@@ -50,7 +50,7 @@
|
|
|
50
50
|
"dependencies": {
|
|
51
51
|
"@modelcontextprotocol/node": "^2.0.0",
|
|
52
52
|
"@modelcontextprotocol/server": "^2.0.0",
|
|
53
|
-
"@parseapi/sdk": "^1.10.
|
|
53
|
+
"@parseapi/sdk": "^1.10.1",
|
|
54
54
|
"zod": "^4.0.0"
|
|
55
55
|
},
|
|
56
56
|
"devDependencies": {
|